askui 0.7.1 → 0.8.0

package/dist/esm/execution/dsl.d.ts

@@ -26,84 +26,6 @@ export declare class Exec extends FluentBase implements Executable {
     exec(): Promise<void>;
 }
 export declare class FluentFilters extends FluentBase {
-    /**
-     * Filters for a UI element 'wizard item active'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    wizardItemActive(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'wizard item'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    wizardItem(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'wizard'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    wizard(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'windows bar'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    windowsBar(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'window'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    window(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'video'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    video(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'url'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    url(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'tooltip'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    tooltip(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'textfield'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    textfield(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'textarea'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    textarea(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'table row'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    tableRow(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'table header'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    tableHeader(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'table column'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    tableColumn(): FluentFiltersOrRelations;
     /**
      * Filters for a UI element 'table'.
      *
@@ -111,496 +33,280 @@ export declare class FluentFilters extends FluentBase {
      */
     table(): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'tab selected'.
+     * Filters for a UI element 'switch'.
      *
      * @return {FluentFiltersOrRelations}
      */
-    tabSelected(): FluentFiltersOrRelations;
+    switch(): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'tab bar'.
+     * Filters for a UI element 'container'.
      *
      * @return {FluentFiltersOrRelations}
      */
-    tabBar(): FluentFiltersOrRelations;
+    container(): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'tab active'.
+     * Filters for a UI element 'checkbox'.
      *
      * @return {FluentFiltersOrRelations}
      */
-    tabActive(): FluentFiltersOrRelations;
+    checkbox(): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'tab'.
+     * Filters for a UI element 'button'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    tab(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'switch enabled'.
+     * **Examples:**
+     * ```typescript
+     * await aui.moveMouseTo().button().exec()
+     * ```
      *
      * @return {FluentFiltersOrRelations}
      */
-    switchEnabled(): FluentFiltersOrRelations;
+    button(): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'switch disabled'.
+     * Filters for an UI element 'text'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    switchDisabled(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'status bar'.
+     * Often combined with the filter `withText()` as shown in the below examples.
+     * See also the filters `withTextRegex()` and `withExactText()`
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    statusBar(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'slider indicator'.
+     * **Examples:**
+     * ```typescript
+     * await aui.click().text().withText('Password').exec();
+     * await aui.click().text().withExactText('Username').exec();
+     * await aui.click().text().withTextRegex('\b[Ss]\w+').exec();
+     * ```
      *
      * @return {FluentFiltersOrRelations}
      */
-    sliderIndicator(): FluentFiltersOrRelations;
+    text(): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'slider'.
+     * Filters for a UI element 'icon'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    slider(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'sidebar'.
+     * You can combine it with the element-description 'withText()' to look for a specific icon.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    sidebar(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'scroll bar'.
+     * **Examples:**
+     * ```typescript
+     * icon().withText('plus')
+     * ```
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    scrollBar(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'rect'.
+     * **Note:** This is an alpha feature. The prediction of the icon name is sometimes unstable. Use custom elements as an alternative.
      *
      * @return {FluentFiltersOrRelations}
      */
-    rect(): FluentFiltersOrRelations;
+    icon(): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'recaptcha'.
+     * Filters for a 'custom element', that is a UI element which is defined by providing an image and other parameters such as degree of rotation. It allows filtering for a UI element that is not recognized by our machine learning models by default. It can also be used for pixel assertions of elements using classical [template matching](https://en.wikipedia.org/wiki/Template_matching).
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    recaptcha(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'rate'.
+     * **Example**
+     * ```typescript
+     * await aui
+     *     .click()
+     *     .customElement({
+     *         customImage: './logo.png', // required
+     *         name: 'myLogo', // optional
+     *         threshold: 0.9, // optional, defaults to 0.9
+     *         rotationDegreePerStep: 0, // optional, defaults to 0
+     *         imageCompareFormat: 'grayscale', // optional, defaults to 'grayscale'
+     *         // mask:{x:0, y:0}[] // optional, a polygon to match only a certain area of the custom element
+     *     })
+     *     .exec();
+     * ```
+     *
+     * **Arguments**
+     *
+     * - **customImage** (*`string`, required*):
+     *     - A cropped image in the form of a base64 string or file path.
+     * - **name** (*`string`, optional*):
+     *     - A unique name that can be used for filtering for the custom element. If not given, any text inside the custom image will be detected via OCR.
+     * - **threshold** (*`number`, optional*):
+     *     - A threshold for how much a UI element needs to be similar to the custom element as defined. Takes values between `0.0` (== all elements are recognized as the custom element which is probably not what you want) and `1.0` (== elements need to look exactly like the `customImage` which is unlikely to be achieved as even minor differences count). Defaults to `0.9`.
+     * - **rotationDegreePerStep** (*`number`, optional*):
+     *     - Step size in rotation degree. Rotates the custom image by this step size until 360° is exceeded. The range is from `0` to `360`. Defaults to `0`.
+     * - **imageCompareFormat** (*`'RGB' | 'grayscale'`, optional*):
+     *     - The color compare style. 'greyscale' compares the brightness of each pixel whereas 'RGB' compares all three color. Defaults to 'grayscale'.
+     * of the given custom image.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    rate(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'radio button unselected'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    radioButtonUnselected(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'radio button selected'.
+     * @param {CustomElementJson} customElement - The custom element to filter for.
      *
      * @return {FluentFiltersOrRelations}
      */
-    radioButtonSelected(): FluentFiltersOrRelations;
+    customElement(customElement: CustomElementJson): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'progressbar'.
+     * Filters for a UI element 'image'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    progressbar(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'progress bar'.
+     * **Examples:**
+     * ```typescript
+     * // Works if there is only one image visible on the screen
+     * await aui.click().image().exec();
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    progressBar(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'popover'.
+     * // Works if you have an image with
+     * // a caption text below
+     * await aui.click().image().above().text().withText('The caption').exec();
+     * ```
      *
      * @return {FluentFiltersOrRelations}
      */
-    popover(): FluentFiltersOrRelations;
+    image(): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'pil'.
+     * Filters for a UI element 'textfield'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    pil(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'password'.
+     * **Examples:**
+     * ```typescript
+     * // Works if there is only one textfield visible on the screen
+     * await aui.typeIn('Oh yeah').textfield().exec();
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    password(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'pager'.
+     * // Works if you have a labeled textfield
+     * // Label is above the textfield
+     * await aui.typeIn('Oh yeah').textfield().below().text().withText('E-Mail Address').exec();
+     * ```
      *
      * @return {FluentFiltersOrRelations}
      */
-    pager(): FluentFiltersOrRelations;
+    textfield(): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'navigation bar'.
+     * Filters for similar (doesn't need to be a 100% equal) text.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    navigationBar(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'mouse text'.
+     * **Examples:**
+     * ```typescript
+     * 'text' === withText('text') => true
+     * 'test' === withText('text') => true
+     * 'Test' === withText('text') => true
+     * 'Text' === withText('text') => true
+     * 'TEXT' === withText('text') => true
+     * 'texst' === withText('text') => true
+     * 'texts' === withText('text') => true
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    mouseText(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'mouse pointer'.
+     * // usually false
+     * 'atebxtc' === withText('text') => false
+     * 'other' === withText('text') => false
+     * ```
+     * ![](https://docs.askui.com/img/gif/withText.gif)
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    mousePointer(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'mouse cursor'.
+     * @param {string} text - A text to be matched.
      *
      * @return {FluentFiltersOrRelations}
      */
-    mouseCursor(): FluentFiltersOrRelations;
+    withText(text: string): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'modal'.
+     * Filters for texts, which match the regex pattern.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    modal(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'message box'.
+     * **Examples:**
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    messageBox(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'map'.
+     * ```typescript
+     * 'The rain in Spain' === withTextRegex('\b[Ss]\w+') => true
+     * 'The rain in Portugal' === withTextRegex('\b[Ss]\w+') => false
+     * 'The rain in switzerland' === withTextRegex('\b[Ss]\w+') => true
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    map(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'logo'.
+     * await aui.get().text().withTextRegex('\b[Ss]\w+').exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    logo(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'link'.
+     * @param {string} regex_pattern - A regex pattern
      *
      * @return {FluentFiltersOrRelations}
      */
-    link(): FluentFiltersOrRelations;
+    withTextRegex(regex_pattern: string): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'keyboard'.
+     * Filters for equal text.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    keyboard(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'image'.
+     * **Note:** This should be only used in cases where the similarity
+     *  comparison of {@link FluentFilters.withText()} allows not for
+     *  specific enough filtering (too many elements).
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    image(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'header'.
+     * **Examples:**
+     * ```typescript
+     * 'text' === withExactText('text') => true
+     * 'test' === withExactText('text') => false
+     * 'other' === withExactText('text') => false
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    header(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'footer'.
+     * await aui.moveMouseTo().text().withExactText('Password').exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    footer(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'flag'.
+     * @param {string} text - A text to be matched.
      *
      * @return {FluentFiltersOrRelations}
      */
-    flag(): FluentFiltersOrRelations;
+    withExactText(text: string): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'dropdown menu'.
+     * Filters for text containing the text provided as an argument.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    dropdownMenu(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'divider'.
+     * **Examples:**
+     * ```typescript
+     * 'This is a text' === containsText('text') => true
+     * 'This is a text' === containsText('other text') => false
+     * 'This is a text' === containsText('other') => false
+     * ```
+     * ![](https://docs.askui.com/img/gif/containsText.gif)
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    divider(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'circle'.
+     * @param {string} text - A text to be matched.
      *
      * @return {FluentFiltersOrRelations}
      */
-    circle(): FluentFiltersOrRelations;
+    containsText(text: string): FluentFiltersOrRelations;
     /**
-     * Filters for a UI element 'checkbox unchecked'.
+     * Filters elements based on a textual description.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    checkboxUnchecked(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'checkbox checked'.
+     * @param {string} text - A description of the target element.
      *
      * @return {FluentFiltersOrRelations}
      */
-    checkboxChecked(): FluentFiltersOrRelations;
+    matching(text: string): FluentFiltersOrRelations;
+}
+export declare class FluentFiltersOrRelations extends FluentFilters {
     /**
-     * Filters for a UI element 'chart pie'.
+     * Logic or operator
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    chartPie(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'chart'.
+     * **Examples:**
+     * ```text
+     * scene 1
+     * --------------  ---------------
+     * |  button    |  |  icon       |
+     * --------------  ---------------
      *
-     * @return {FluentFiltersOrRelations}
+     * scene 2
+     * --------------  ---------------
+     * |  button    |  |  text       |
+     * --------------  ---------------
+     *
+     * ```
+     * In case, that your reference element can have multiple values, in the following example, the element right of the button can be either icon or text.
+     * You can use **the `or()` relation**, so your instruction is valid for both scenes
+     * ```typescript
+     * const button = await aui.get().button().rightOf().icon().or().text().exec();
+     * console.log(button);
+     * ```
+     * Returns the same button for both cases
+     * ```text
+     *  console output: [
+     *   DetectedElement {
+     *      name: 'BUTTON',
+     *      text: 'button',
+     *      bndbox: BoundingBox {
+     *         xmin: 900,
+     *         ymin: 910,
+     *         xmax: 920,
+     *         ymax: 930
+     *      }
+     *   }
+     *  ]
+     * ```
+     *
+     * @return {FluentFilters}
      */
-    chart(): FluentFiltersOrRelations;
+    or(): FluentFilters;
     /**
-     * Filters for a UI element 'card'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    card(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'browser bar'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    browserBar(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'breadcrumb'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    breadcrumb(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'banner'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    banner(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'badge'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    badge(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'alert'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    alert(): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'unknown'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    unknown(): FluentFiltersOrRelations;
-    /**
-     * Filters for an UI element 'button'.
-     *
-     * **Examples:**
-     * ```typescript
-     * await aui.moveMouseTo().button().exec()
-     * ```
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    button(): FluentFiltersOrRelations;
-    /**
-     * Filters for an UI element 'text'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    text(): FluentFiltersOrRelations;
-    /**
-     * Filters for an UI element 'dropdown'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    dropdown(): FluentFiltersOrRelations;
-    /**
-     * Filters for an UI element 'icon'.
-     *
-     * You can combine it with the 'withText' command to look for a specific icon.
-     *
-     * **Examples:**
-     * ```typescript
-     * icon().withText('plus')
-     * ```
-     *
-     * Note: This is an alpha feature. The prediction of the icon name is sometimes unstable. Use custom elements as an alternative.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    icon(): FluentFiltersOrRelations;
-    /**
-     * Filters for a custom UI element (see {@link CustomElementJson}).
-     *
-     * **Important**: This increases the runtime quite a bit. So
-     *  only use it when absolutely necessary.
-     *
-     * @param {CustomElementJson} customElement - The custom element to filter for.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    customElement(customElement: CustomElementJson): FluentFiltersOrRelations;
-    /**
-     * Filters for a UI element 'checkbox' checked or unchecked.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    checkbox(): FluentFiltersOrRelations;
-    /**
-     * Filters for similar (doesn't need to be a 100% equal) text.
-     *
-     * **Examples:**
-     * ```typescript
-     * 'text' === withText('text') => true
-     * 'test' === withText('text') => true
-     * 'Test' === withText('text') => true
-     * 'Text' === withText('text') => true
-     * 'TEXT' === withText('text') => true
-     * 'texst' === withText('text') => true
-     * 'texts' === withText('text') => true
-     *
-     * // usually false
-     * 'atebxtc' === withText('text') => false
-     * 'other' === withText('text') => false
-     * ```
-     * ![](https://docs.askui.com/img/gif/withText.gif)
-     *
-     * @param {string} text - A text to be matched.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    withText(text: string): FluentFiltersOrRelations;
-    /**
-     * Filters for texts, which match the regex pattern.
-     *
-     * **Examples:**
-     *
-     * ```typescript
-     * 'The rain in Spain' === withTextRegex('\b[Ss]\w+') => true
-     * 'The rain in Portugal' === withTextRegex('\b[Ss]\w+') => false
-     * 'The rain in switzerland' === withTextRegex('\b[Ss]\w+') => true
-     *
-     * await aui.get().text().withTextRegex('\b[Ss]\w+').exec()
-     * ```
-     *
-     * @param {string} regex_pattern - A regex pattern
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    withTextRegex(regex_pattern: string): FluentFiltersOrRelations;
-    /**
-     * Filters for equal text.
-     *
-     * **Note:** This should be only used in cases where the similarity
-     *  comparison of {@link FluentFilters.withText()} allows not for
-     *  specific enough filtering (too many elements).
-     *
-     * **Examples:**
-     * ```typescript
-     * 'text' === withExactText('text') => true
-     * 'test' === withExactText('text') => false
-     * 'other' === withExactText('text') => false
-     *
-     * await aui.moveMouseTo().text().withExactText('Password').exec()
-     * ```
-     *
-     * @param {string} text - A text to be matched.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    withExactText(text: string): FluentFiltersOrRelations;
-    /**
-     * Filters for text containing the text provided as an argument.
-     *
-     * **Examples:**
-     * ```typescript
-     * 'This is an text' === containsText('text') => true
-     * 'This is an text' === containsText('other text') => false
-     * 'This is an text' === containsText('other') => false
-     * ```
-     * ![](https://docs.askui.com/img/gif/containsText.gif)
-     *
-     * @param {string} text - A text to be matched.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    containsText(text: string): FluentFiltersOrRelations;
-}
-export declare class FluentFiltersOrRelations extends FluentFilters {
-    /**
-     * Logic or operator
-     *
-     * **Examples:**
-     * ```text
-     * scene 1
-     * --------------  ---------------
-     * |  button    |  |  icon       |
-     * --------------  ---------------
-     *
-     * scene 2
-     * --------------  ---------------
-     * |  button    |  |  text       |
-     * --------------  ---------------
-     *
-     * ```
-     * In case, that your reference element can have multiple values, in the following example, the element right of the button can be either icon or text.
-     * You can use **the `or()` relation**, so your teststep is valid for both scenes
-     * ```typescript
-     * const button = await aui.get().button().rightOf().icon().or().text().exec();
-     * console.log(button);
-     * ```
-     * Returns the same button for both cases
-     * ```text
-     *  console output: [
-     *   DetectedElement {
-     *      name: 'BUTTON',
-     *      text: 'button',
-     *      bndbox: BoundingBox {
-     *         xmin: 900,
-     *         ymin: 910,
-     *         xmax: 920,
-     *         ymax: 930
-     *      }
-     *   }
-     *  ]
-     * ```
-     *
-     * @return {FluentFilters}
-     */
-    or(): FluentFilters;
-    /**
-     * Logic and operator
+     * Logic and operator
      *
      * **Examples:**
      * ```text
      * example scene:
      *  ---------------   ----------------
      *  |  icon user  |   |  icon search |
-     *  ---------------   ---------------n```
+     *  ---------------   ----------------
+     * ```
      * ```typescript
      * const icons = await aui.get().icon().exec();
      * console.log(icons);
      * ```
-     * Using only the filter icon, the get command will return both icons
+     * Using only the element-description icon, the get will return both icons
      * ```text
      * console output: [
      *   DetectedElement {
@@ -625,12 +331,12 @@ export declare class FluentFiltersOrRelations extends FluentFilters {
      *   }
      *  ]
      * ```
-     * You can combine filters with **the `and()` relation** and specify exactly which icon you want
+     * You can combine element-descriptions with **the `and()` relation** and specify exactly which icon you want.
      * ```typescript
      * const icons = await aui.get().icon().and().withText('user').exec()
      * console.log(icons)
      * ```
-     * The get command returns only the user icon although both elements are icons
+     * The get returns only the user icon although both elements are icons.
      * ```text
      *  console output: [
      *   DetectedElement {
@@ -779,419 +485,59 @@ export declare class FluentFiltersOrRelations extends FluentFilters {
      *
      * @return {FluentFilters}
      */
-    nearestTo(): FluentFilters;
-    /**
-     * Filters for an element containing another element.
-     *
-     * **Example:**
-     * ```typescript
-     * --------------------
-     * |     outerEl      |
-     * |  --------------  |
-     * |  |  innerEl   |  |
-     * |  --------------  |
-     * |                  |
-     * --------------------
-     *
-     * // Returns outerEl because outerEl contains innerEl
-     * ...outerEl().contains().innerEl()
-     * //  Returns no element because innerEl contains no outerEl
-     * ...innerEl().contains().outerEl()
-     * ```
-     * ![](https://docs.askui.com/img/gif/contains.gif)
-     *
-     * @return {FluentFilters}
-     */
-    contains(): FluentFilters;
-    exec(): Promise<void>;
-}
-export declare class FluentFiltersCondition extends FluentBase {
-    /**
-     * Filters for a UI element 'wizard item active'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    wizardItemActive(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'wizard item'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    wizardItem(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'wizard'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    wizard(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'windows bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    windowsBar(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'window'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    window(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'video'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    video(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'url'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    url(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'tooltip'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tooltip(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'textfield'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    textfield(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'textarea'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    textarea(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'table row'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tableRow(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'table header'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tableHeader(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'table column'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tableColumn(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'table'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    table(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'tab selected'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tabSelected(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'tab bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tabBar(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'tab active'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tabActive(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'tab'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tab(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'switch enabled'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    switchEnabled(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'switch disabled'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    switchDisabled(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'status bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    statusBar(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'slider indicator'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    sliderIndicator(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'slider'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    slider(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'sidebar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    sidebar(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'scroll bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    scrollBar(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'rect'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    rect(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'recaptcha'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    recaptcha(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'rate'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    rate(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'radio button unselected'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    radioButtonUnselected(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'radio button selected'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    radioButtonSelected(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'progressbar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    progressbar(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'progress bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    progressBar(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'popover'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    popover(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'pil'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    pil(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'password'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    password(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'pager'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    pager(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'navigation bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    navigationBar(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'mouse text'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    mouseText(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'mouse pointer'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    mousePointer(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'mouse cursor'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    mouseCursor(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'modal'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    modal(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'message box'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    messageBox(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'map'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    map(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'logo'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    logo(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'link'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    link(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'keyboard'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    keyboard(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'image'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    image(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'header'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    header(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'footer'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    footer(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'flag'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    flag(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'dropdown menu'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    dropdownMenu(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'divider'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    divider(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'circle'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    circle(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'checkbox unchecked'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    checkboxUnchecked(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'checkbox checked'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    checkboxChecked(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'chart pie'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    chartPie(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'chart'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    chart(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'card'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    card(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for a UI element 'browser bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    browserBar(): FluentFiltersOrRelationsCondition;
+    nearestTo(): FluentFilters;
     /**
-     * Filters for a UI element 'breadcrumb'.
+     * Filters for an element containing another element.
      *
-     * @return {FluentFiltersOrRelationsCondition}
+     * **Example:**
+     * ```typescript
+     * --------------------
+     * |     outerEl      |
+     * |  --------------  |
+     * |  |  innerEl   |  |
+     * |  --------------  |
+     * |                  |
+     * --------------------
+     *
+     * // Returns outerEl because outerEl contains innerEl
+     * ...outerEl().contains().innerEl()
+     * //  Returns no element because innerEl contains no outerEl
+     * ...innerEl().contains().outerEl()
+     * ```
+     * ![](https://docs.askui.com/img/gif/contains.gif)
+     *
+     * @return {FluentFilters}
      */
-    breadcrumb(): FluentFiltersOrRelationsCondition;
+    contains(): FluentFilters;
+    exec(): Promise<void>;
+}
+export declare class FluentFiltersCondition extends FluentBase {
     /**
-     * Filters for a UI element 'banner'.
+     * Filters for a UI element 'table'.
      *
      * @return {FluentFiltersOrRelationsCondition}
      */
-    banner(): FluentFiltersOrRelationsCondition;
+    table(): FluentFiltersOrRelationsCondition;
     /**
-     * Filters for a UI element 'badge'.
+     * Filters for a UI element 'switch'.
      *
      * @return {FluentFiltersOrRelationsCondition}
      */
-    badge(): FluentFiltersOrRelationsCondition;
+    switch(): FluentFiltersOrRelationsCondition;
     /**
-     * Filters for a UI element 'alert'.
+     * Filters for a UI element 'container'.
      *
      * @return {FluentFiltersOrRelationsCondition}
      */
-    alert(): FluentFiltersOrRelationsCondition;
+    container(): FluentFiltersOrRelationsCondition;
     /**
-     * Filters for a UI element 'unknown'.
+     * Filters for a UI element 'checkbox'.
      *
      * @return {FluentFiltersOrRelationsCondition}
      */
-    unknown(): FluentFiltersOrRelationsCondition;
+    checkbox(): FluentFiltersOrRelationsCondition;
     /**
-     * Filters for an UI element 'button'.
+     * Filters for a UI element 'button'.
      *
      * **Examples:**
      * ```typescript
@@ -1204,35 +550,66 @@ export declare class FluentFiltersCondition extends FluentBase {
     /**
      * Filters for an UI element 'text'.
      *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    text(): FluentFiltersOrRelationsCondition;
-    /**
-     * Filters for an UI element 'dropdown'.
+     * Often combined with the filter `withText()` as shown in the below examples.
+     * See also the filters `withTextRegex()` and `withExactText()`
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.click().text().withText('Password').exec();
+     * await aui.click().text().withExactText('Username').exec();
+     * await aui.click().text().withTextRegex('\b[Ss]\w+').exec();
+     * ```
      *
      * @return {FluentFiltersOrRelationsCondition}
      */
-    dropdown(): FluentFiltersOrRelationsCondition;
+    text(): FluentFiltersOrRelationsCondition;
     /**
-     * Filters for an UI element 'icon'.
+     * Filters for a UI element 'icon'.
      *
-     * You can combine it with the 'withText' command to look for a specific icon.
+     * You can combine it with the element-description 'withText()' to look for a specific icon.
      *
      * **Examples:**
      * ```typescript
      * icon().withText('plus')
      * ```
      *
-     * Note: This is an alpha feature. The prediction of the icon name is sometimes unstable. Use custom elements as an alternative.
+     * **Note:** This is an alpha feature. The prediction of the icon name is sometimes unstable. Use custom elements as an alternative.
      *
      * @return {FluentFiltersOrRelationsCondition}
      */
     icon(): FluentFiltersOrRelationsCondition;
     /**
-     * Filters for a custom UI element (see {@link CustomElementJson}).
+     * Filters for a 'custom element', that is a UI element which is defined by providing an image and other parameters such as degree of rotation. It allows filtering for a UI element that is not recognized by our machine learning models by default. It can also be used for pixel assertions of elements using classical [template matching](https://en.wikipedia.org/wiki/Template_matching).
+     *
+     * **Example**
+     * ```typescript
+     * await aui
+     *     .click()
+     *     .customElement({
+     *         customImage: './logo.png', // required
+     *         name: 'myLogo', // optional
+     *         threshold: 0.9, // optional, defaults to 0.9
+     *         rotationDegreePerStep: 0, // optional, defaults to 0
+     *         imageCompareFormat: 'grayscale', // optional, defaults to 'grayscale'
+     *         // mask:{x:0, y:0}[] // optional, a polygon to match only a certain area of the custom element
+     *     })
+     *     .exec();
+     * ```
+     *
+     * **Arguments**
+     *
+     * - **customImage** (*`string`, required*):
+     *     - A cropped image in the form of a base64 string or file path.
+     * - **name** (*`string`, optional*):
+     *     - A unique name that can be used for filtering for the custom element. If not given, any text inside the custom image will be detected via OCR.
+     * - **threshold** (*`number`, optional*):
+     *     - A threshold for how much a UI element needs to be similar to the custom element as defined. Takes values between `0.0` (== all elements are recognized as the custom element which is probably not what you want) and `1.0` (== elements need to look exactly like the `customImage` which is unlikely to be achieved as even minor differences count). Defaults to `0.9`.
+     * - **rotationDegreePerStep** (*`number`, optional*):
+     *     - Step size in rotation degree. Rotates the custom image by this step size until 360° is exceeded. The range is from `0` to `360`. Defaults to `0`.
+     * - **imageCompareFormat** (*`'RGB' | 'grayscale'`, optional*):
+     *     - The color compare style. 'greyscale' compares the brightness of each pixel whereas 'RGB' compares all three color. Defaults to 'grayscale'.
+     * of the given custom image.
      *
-     * **Important**: This increases the runtime quite a bit. So
-     *  only use it when absolutely necessary.
      *
      * @param {CustomElementJson} customElement - The custom element to filter for.
      *
@@ -1240,11 +617,37 @@ export declare class FluentFiltersCondition extends FluentBase {
      */
     customElement(customElement: CustomElementJson): FluentFiltersOrRelationsCondition;
     /**
-     * Filters for a UI element 'checkbox' checked or unchecked.
+     * Filters for a UI element 'image'.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Works if there is only one image visible on the screen
+     * await aui.click().image().exec();
+     *
+     * // Works if you have an image with
+     * // a caption text below
+     * await aui.click().image().above().text().withText('The caption').exec();
+     * ```
      *
      * @return {FluentFiltersOrRelationsCondition}
      */
-    checkbox(): FluentFiltersOrRelationsCondition;
+    image(): FluentFiltersOrRelationsCondition;
+    /**
+     * Filters for a UI element 'textfield'.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Works if there is only one textfield visible on the screen
+     * await aui.typeIn('Oh yeah').textfield().exec();
+     *
+     * // Works if you have a labeled textfield
+     * // Label is above the textfield
+     * await aui.typeIn('Oh yeah').textfield().below().text().withText('E-Mail Address').exec();
+     * ```
+     *
+     * @return {FluentFiltersOrRelationsCondition}
+     */
+    textfield(): FluentFiltersOrRelationsCondition;
     /**
      * Filters for similar (doesn't need to be a 100% equal) text.
      *
@@ -1313,9 +716,9 @@ export declare class FluentFiltersCondition extends FluentBase {
      *
      * **Examples:**
      * ```typescript
-     * 'This is an text' === containsText('text') => true
-     * 'This is an text' === containsText('other text') => false
-     * 'This is an text' === containsText('other') => false
+     * 'This is a text' === containsText('text') => true
+     * 'This is a text' === containsText('other text') => false
+     * 'This is a text' === containsText('other') => false
      * ```
      * ![](https://docs.askui.com/img/gif/containsText.gif)
      *
@@ -1324,6 +727,14 @@ export declare class FluentFiltersCondition extends FluentBase {
      * @return {FluentFiltersOrRelationsCondition}
      */
     containsText(text: string): FluentFiltersOrRelationsCondition;
+    /**
+     * Filters elements based on a textual description.
+     *
+     * @param {string} text - A description of the target element.
+     *
+     * @return {FluentFiltersOrRelationsCondition}
+     */
+    matching(text: string): FluentFiltersOrRelationsCondition;
 }
 export declare class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
     /**
@@ -1343,7 +754,7 @@ export declare class FluentFiltersOrRelationsCondition extends FluentFiltersCond
      *
      * ```
      * In case, that your reference element can have multiple values, in the following example, the element right of the button can be either icon or text.
-     * You can use **the `or()` relation**, so your teststep is valid for both scenes
+     * You can use **the `or()` relation**, so your instruction is valid for both scenes
      * ```typescript
      * const button = await aui.get().button().rightOf().icon().or().text().exec();
      * console.log(button);
@@ -1375,12 +786,13 @@ export declare class FluentFiltersOrRelationsCondition extends FluentFiltersCond
      * example scene:
      *  ---------------   ----------------
      *  |  icon user  |   |  icon search |
-     *  ---------------   ---------------n```
+     *  ---------------   ----------------
+     * ```
      * ```typescript
      * const icons = await aui.get().icon().exec();
      * console.log(icons);
      * ```
-     * Using only the filter icon, the get command will return both icons
+     * Using only the element-description icon, the get will return both icons
      * ```text
      * console output: [
      *   DetectedElement {
@@ -1405,12 +817,12 @@ export declare class FluentFiltersOrRelationsCondition extends FluentFiltersCond
      *   }
      *  ]
      * ```
-     * You can combine filters with **the `and()` relation** and specify exactly which icon you want
+     * You can combine element-descriptions with **the `and()` relation** and specify exactly which icon you want.
      * ```typescript
      * const icons = await aui.get().icon().and().withText('user').exec()
      * console.log(icons)
      * ```
-     * The get command returns only the user icon although both elements are icons
+     * The get returns only the user icon although both elements are icons.
      * ```text
      *  console output: [
      *   DetectedElement {
@@ -1586,20 +998,46 @@ export declare class FluentFiltersOrRelationsCondition extends FluentFiltersCond
     /**
      * Expects that filtered element exists.
      *
+     * Always use together with `expect()`.
+     *
+     * **Note** Throws an error and stops the execution when the element is not found. You can catch the error and decide what to do as in the examples below.
+     *
      * **Examples:**
      * ```typescript
+     * // Stops execution at this point when the element does not exist.
      * await aui.expect().text().withText('Login').exists().exec()
+     *
+     * // This will catch the error and log a message
+     * // But the execution will continue afterwards
+     * try {
+     *     await aui.expect().text().withText('Login').exists().exec()
+     * } catch (error) {
+     *     console.log('Too bad we could not find the element!');
+     * }
      * ```
      *
      * @return {ExecCondition}
      */
     exists(): ExecCondition;
     /**
-     * Expects that filtered element does not exist.
+     * Expects that filtered element not exists.
+     *
+     * Always use together with `expect()`.
+     *
+     * **Note** Throws an error and stops the execution when the element is found. You can catch the error and decide what to do as in the examples below.
      *
      * **Examples:**
      * ```typescript
+     * // Stops execution at this point when the element does exist.
      * await aui.expect().text().withText('Login').notExists().exec()
+     *
+     * // This will catch the error and log a message
+     * // But the execution will continue afterwards
+     * try {
+     *     await aui.expect().text().withText('Login').notExists().exec()
+     * } catch (error) {
+     *     console.log('Too bad we could find the element!');
+     * }
      * ```
      *
      * @return {ExecCondition}
@@ -1613,6 +1051,8 @@ export declare abstract class FluentCommand extends FluentBase {
     /**
      * Expects a condition, e.g., `exists()` or `notExits()`.
      *
+     * Use the structure `expect().<your filter>.(exists()|notExists()` as shown in the examples below.
+     *
      * **Examples:**
      * ```typescript
      * await aui.expect().text().withText('Login').exists().exec()
@@ -1623,7 +1063,9 @@ export declare abstract class FluentCommand extends FluentBase {
      */
     expect(): FluentFiltersCondition;
     /**
-     * Clicks on the filtered element.
+     * Mouse left-clicks/taps on the filtered element by moving the mouse cursor to the filtered element first.
+     *
+     * If you need a simple mouseleftclick/tap only, use `mouseLeftClick`.
      *
      * **Example:**
      * ```typescript
@@ -1647,6 +1089,8 @@ export declare abstract class FluentCommand extends FluentBase {
     /**
      * Puts the focus on the filtered element and types in the text.
      *
+     * **Note:** In the current version it copies the text and pastes it.
+     *
      * **Examples:**
      * ```typescript
      * await aui.typeIn('Type some text').textfield().exec()
@@ -1716,11 +1160,14 @@ export declare abstract class FluentCommand extends FluentBase {
      * Types a text at the current position.
      * If you need to focus the element first, use typeIn()
      *
+     * **Note:** In the current version it copies the text and pastes it.
+     *
      * **Examples:**
      * ```typescript
      * await aui.type('Type some text').exec()
      *
-     * // mask the text so it is not send to the askui-inference serverawait aui.type('Type some text', { isSecret: true, secretMask: '**' }).exec()
+     * // mask the text so it is not send to the askui-inference server
+     * await aui.type('Type some text', { isSecret: true, secretMask: '**' }).exec()
      * ```
      *
      * @param {string} text - A text to type
@@ -1731,6 +1178,11 @@ export declare abstract class FluentCommand extends FluentBase {
     /**
      * Moves the mouse from the current position (relative) in x and y direction.
      *
+     * **Example:**
+     * ```typescript
+     * await aui.moveMouseRelatively(20, 20).exec();
+     * ```
+     *
      * @param {number} x_offset - A (positive/negative) x direction.
      * @param {number} y_offset - A (positive/negative) y direction.
      *
@@ -1740,6 +1192,13 @@ export declare abstract class FluentCommand extends FluentBase {
     /**
      * Moves the mouse to the absolute x and y coordinates.
      *
+     * If you want to move your mouse cursor to an element, use `moveMouseTo()`.
+     *
+     * **Example:**
+     * ```typescript
+     * await aui.moveMouse(500, 500).exec();
+     * ```
+     *
      * @param {number} x_coordinate - A (positive/negative) x coordinate.
      * @param {number} y_coordinate - A (positive/negative) y coordinate.
      *
@@ -1762,520 +1221,254 @@ export declare abstract class FluentCommand extends FluentBase {
      * @param {number} x_offset - A (positive/negative) x direction.
      * @param {number} y_offset - A (positive/negative) y direction.
      *
-     * @return {Exec}
-     */
-    scroll(x_offset: number, y_offset: number): Exec;
-    /**
-     * Executes a shell command on the device.
-     *
-     * **Example:**
-     * ```typescript
-     * // Open the lastpass app
-     * await aui.execOnShell('monkey -p com.lastpass.authenticator 1').exec()
-     * ```
-     *
-     * @param {string} shell_command - A shell command which is executed.
-     *
-     * @return {Exec}
-     */
-    execOnShell(shell_command: string): Exec;
-    /**
-     * Clicks with left mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseLeftClick(): Exec;
-    /**
-     * Clicks with right mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseRightClick(): Exec;
-    /**
-     * Clicks with middle mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseMiddleClick(): Exec;
-    /**
-     * Double-clicks with left mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseDoubleLeftClick(): Exec;
-    /**
-     * Double-clicks with right mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseDoubleRightClick(): Exec;
-    /**
-     * Double-clicks with middle mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseDoubleMiddleClick(): Exec;
-    /**
-     * Toggles mouse down (Left mouse key).
-     *
-     * @return {Exec}
-     */
-    mouseToggleDown(): Exec;
-    /**
-     * Toggles mouse up (Left mouse key).
-     *
-     * @return {Exec}
-     */
-    mouseToggleUp(): Exec;
-    /**
-     * Press three keys like `CTRL+ALT+DEL`
-     *
-     * @param {MODIFIER_KEY} first_key - A modifier key
-     * @param {MODIFIER_KEY} second_key - A modifier key
-     * @param {PC_KEY} third_key - A key
-     *
-     * @return {Exec}
-     */
-    pressThreeKeys(first_key: MODIFIER_KEY, second_key: MODIFIER_KEY, third_key: PC_KEY): Exec;
-    /**
-     * Press two keys like `ALT+F4`
-     *
-     * @param {MODIFIER_KEY} first_key - A modifier key
-     * @param {PC_KEY} second_key - A key
-     *
-     * @return {Exec}
-     */
-    pressTwoKeys(first_key: MODIFIER_KEY, second_key: PC_KEY): Exec;
-    /**
-     * Press one keys like `DEL`
-     *
-     * @param {PC_AND_MODIFIER_KEY} key - A key
-     *
-     * @return {Exec}
-     */
-    pressKey(key: PC_AND_MODIFIER_KEY): Exec;
-    /**
-     * Press three Android keys like `CTRL+ALT+DEL`
-     *
-     * @param {ANDROID_KEY} first_key - A Android key
-     * @param {ANDROID_KEY} second_key - A Android key
-     * @param {ANDROID_KEY} third_key - A Android key
-     *
-     * @return {Exec}
-     */
-    pressAndroidThirdKey(first_key: ANDROID_KEY, second_key: ANDROID_KEY, third_key: ANDROID_KEY): Exec;
-    /**
-     * Press two Android keys like `ALT+F4`
-     *
-     * @param {ANDROID_KEY} first_key - A Android key
-     * @param {ANDROID_KEY} second_key - A Android key
-     *
-     * @return {Exec}
-     */
-    pressAndroidTwoKey(first_key: ANDROID_KEY, second_key: ANDROID_KEY): Exec;
-    /**
-     * Press one Android keys like `DEL`
-     *
-     * @param {ANDROID_KEY} key - A Android key
-     *
-     * @return {Exec}
-     */
-    pressAndroidKey(key: ANDROID_KEY): Exec;
-    abstract fluentCommandExecutor(instruction: string, customElements: CustomElementJson[]): Promise<void>;
-}
-export interface ExecutableGetter {
-    exec(): Promise<DetectedElement[]>;
-}
-export declare class ExecGetter extends FluentBase implements ExecutableGetter {
-    exec(): Promise<DetectedElement[]>;
-}
-export declare class FluentFiltersGetter extends FluentBase {
-    /**
-     * Filters for a UI element 'wizard item active'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    wizardItemActive(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'wizard item'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    wizardItem(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'wizard'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    wizard(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'windows bar'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    windowsBar(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'window'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    window(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'video'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    video(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'url'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    url(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'tooltip'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tooltip(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'textfield'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    textfield(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'textarea'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    textarea(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'table row'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tableRow(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'table header'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    tableHeader(): FluentFiltersOrRelationsGetter;
+    scroll(x_offset: number, y_offset: number): Exec;
     /**
-     * Filters for a UI element 'table column'.
+     * Executes a shell command on the device your UiController is connected to.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tableColumn(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'table'.
+     * **Example:**
+     * ```typescript
+     * // Open the lastpass app
+     * await aui.execOnShell('monkey -p com.lastpass.authenticator 1').exec();
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    table(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'tab selected'.
+     * // Open Google Chrome on Windows
+     * await aui.execOnShell("start chrome").exec()
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tabSelected(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'tab bar'.
+     * ;// Open Google Chrome on macOS
+     * await aui.execOnShell("open -a 'Google Chrome'").exec();
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tabBar(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'tab active'.
+     * // Open Google Chrome on Linux
+     * await aui.execOnShell("chrome").exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tabActive(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'tab'.
+     * @param {string} shell_command - A shell command which is executed.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    tab(): FluentFiltersOrRelationsGetter;
+    execOnShell(shell_command: string): Exec;
     /**
-     * Filters for a UI element 'switch enabled'.
+     * Clicks with left mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    switchEnabled(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'switch disabled'.
+     * If you need to move the mouse first, use `moveMouseTo()`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    switchDisabled(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'status bar'.
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    statusBar(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'slider indicator'.
+     * await aui.mouseLeftClick().exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    sliderIndicator(): FluentFiltersOrRelationsGetter;
+    mouseLeftClick(): Exec;
     /**
-     * Filters for a UI element 'slider'.
+     * Clicks with right mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    slider(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'sidebar'.
+     * If you need to move the mouse first, use `moveMouseTo()`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    sidebar(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'scroll bar'.
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    scrollBar(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'rect'.
+     * await aui.mouseRightClick().exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    rect(): FluentFiltersOrRelationsGetter;
+    mouseRightClick(): Exec;
     /**
-     * Filters for a UI element 'recaptcha'.
+     * Clicks with middle mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    recaptcha(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'rate'.
+     * If you need to move the mouse first, use `moveMouseTo()`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    rate(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'radio button unselected'.
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    radioButtonUnselected(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'radio button selected'.
+     * await aui.mouseMiddleClick().exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    radioButtonSelected(): FluentFiltersOrRelationsGetter;
+    mouseMiddleClick(): Exec;
     /**
-     * Filters for a UI element 'progressbar'.
+     * Double-clicks with left mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    progressbar(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'progress bar'.
+     * If you need to move the mouse first, use `moveMouseTo()`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    progressBar(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'popover'.
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    popover(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'pil'.
+     * await aui.mouseDoubleLeftClick().exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    pil(): FluentFiltersOrRelationsGetter;
+    mouseDoubleLeftClick(): Exec;
     /**
-     * Filters for a UI element 'password'.
+     * Double-clicks with right mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    password(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'pager'.
+     * If you need to move the mouse first, use `moveMouseTo()`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    pager(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'navigation bar'.
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    navigationBar(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'mouse text'.
+     * await aui.mouseDoubleRightClick().exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    mouseText(): FluentFiltersOrRelationsGetter;
+    mouseDoubleRightClick(): Exec;
     /**
-     * Filters for a UI element 'mouse pointer'.
+     * Double-clicks with middle mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    mousePointer(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'mouse cursor'.
+     * If you need to move the mouse first, use `moveMouseTo()`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    mouseCursor(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'modal'.
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    modal(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'message box'.
+     * await aui.mouseDoubleMiddleClick().exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    messageBox(): FluentFiltersOrRelationsGetter;
+    mouseDoubleMiddleClick(): Exec;
     /**
-     * Filters for a UI element 'map'.
+     * Toggles mouse down (Left mouse key/tap).
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    map(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'logo'.
+     * **Example:**
+     * ```typescript
+     * await aui.mouseToggleDown().exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    logo(): FluentFiltersOrRelationsGetter;
+    mouseToggleDown(): Exec;
     /**
-     * Filters for a UI element 'link'.
+     * Toggles mouse up (Left mouse key/tap).
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    link(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'keyboard'.
+     * **Example:**
+     * ```typescript
+     * await aui.mouseToggleUp().exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    keyboard(): FluentFiltersOrRelationsGetter;
+    mouseToggleUp(): Exec;
     /**
-     * Filters for a UI element 'image'.
+     * Press three keys like `CTRL+ALT+DEL`
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    image(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'header'.
+     * **Operating system specific mappings:**
+     * 1. Windows: `command`-key maps to `windows`-key
+     * ---
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    header(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'footer'.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    footer(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'flag'.
+     * @param {MODIFIER_KEY} first_key - A modifier key
+     * @param {MODIFIER_KEY} second_key - A modifier key
+     * @param {PC_KEY} third_key - A key
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    flag(): FluentFiltersOrRelationsGetter;
+    pressThreeKeys(first_key: MODIFIER_KEY, second_key: MODIFIER_KEY, third_key: PC_KEY): Exec;
     /**
-     * Filters for a UI element 'dropdown menu'.
+     * Press two keys like `ALT+F4`
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    dropdownMenu(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'divider'.
+     * **Operating system specific mappings:**
+     * 1. Windows: `command`-key maps to `windows`-key
+     * ---
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    divider(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'circle'.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    circle(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'checkbox unchecked'.
+     * @param {MODIFIER_KEY} first_key - A modifier key
+     * @param {PC_KEY} second_key - A key
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    checkboxUnchecked(): FluentFiltersOrRelationsGetter;
+    pressTwoKeys(first_key: MODIFIER_KEY, second_key: PC_KEY): Exec;
     /**
-     * Filters for a UI element 'checkbox checked'.
+     * Press one keys like `DEL`
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    checkboxChecked(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'chart pie'.
+     * **Operating system specific mappings:**
+     * 1. Windows: `command`-key maps to `windows`-key
+     * ---
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    chartPie(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for a UI element 'chart'.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @param {PC_AND_MODIFIER_KEY} key - A key
+     *
+     * @return {Exec}
      */
-    chart(): FluentFiltersOrRelationsGetter;
+    pressKey(key: PC_AND_MODIFIER_KEY): Exec;
     /**
-     * Filters for a UI element 'card'.
+     * Press three Android keys like `CTRL+ALT+DEL`
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @param {ANDROID_KEY} first_key - A Android key
+     * @param {ANDROID_KEY} second_key - A Android key
+     * @param {ANDROID_KEY} third_key - A Android key
+     *
+     * @return {Exec}
      */
-    card(): FluentFiltersOrRelationsGetter;
+    pressAndroidThirdKey(first_key: ANDROID_KEY, second_key: ANDROID_KEY, third_key: ANDROID_KEY): Exec;
     /**
-     * Filters for a UI element 'browser bar'.
+     * Press two Android keys like `ALT+F4`
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @param {ANDROID_KEY} first_key - A Android key
+     * @param {ANDROID_KEY} second_key - A Android key
+     *
+     * @return {Exec}
      */
-    browserBar(): FluentFiltersOrRelationsGetter;
+    pressAndroidTwoKey(first_key: ANDROID_KEY, second_key: ANDROID_KEY): Exec;
     /**
-     * Filters for a UI element 'breadcrumb'.
+     * Press one Android key like `DEL`
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @param {ANDROID_KEY} key - A Android key
+     *
+     * @return {Exec}
      */
-    breadcrumb(): FluentFiltersOrRelationsGetter;
+    pressAndroidKey(key: ANDROID_KEY): Exec;
+    abstract fluentCommandExecutor(instruction: string, customElements: CustomElementJson[]): Promise<void>;
+}
+export interface ExecutableGetter {
+    exec(): Promise<DetectedElement[]>;
+}
+export declare class ExecGetter extends FluentBase implements ExecutableGetter {
+    exec(): Promise<DetectedElement[]>;
+}
+export declare class FluentFiltersGetter extends FluentBase {
     /**
-     * Filters for a UI element 'banner'.
+     * Filters for a UI element 'table'.
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    banner(): FluentFiltersOrRelationsGetter;
+    table(): FluentFiltersOrRelationsGetter;
     /**
-     * Filters for a UI element 'badge'.
+     * Filters for a UI element 'switch'.
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    badge(): FluentFiltersOrRelationsGetter;
+    switch(): FluentFiltersOrRelationsGetter;
     /**
-     * Filters for a UI element 'alert'.
+     * Filters for a UI element 'container'.
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    alert(): FluentFiltersOrRelationsGetter;
+    container(): FluentFiltersOrRelationsGetter;
     /**
-     * Filters for a UI element 'unknown'.
+     * Filters for a UI element 'checkbox'.
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    unknown(): FluentFiltersOrRelationsGetter;
+    checkbox(): FluentFiltersOrRelationsGetter;
     /**
-     * Filters for an UI element 'button'.
+     * Filters for a UI element 'button'.
      *
      * **Examples:**
      * ```typescript
@@ -2288,35 +1481,66 @@ export declare class FluentFiltersGetter extends FluentBase {
     /**
      * Filters for an UI element 'text'.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    text(): FluentFiltersOrRelationsGetter;
-    /**
-     * Filters for an UI element 'dropdown'.
+     * Often combined with the filter `withText()` as shown in the below examples.
+     * See also the filters `withTextRegex()` and `withExactText()`
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.click().text().withText('Password').exec();
+     * await aui.click().text().withExactText('Username').exec();
+     * await aui.click().text().withTextRegex('\b[Ss]\w+').exec();
+     * ```
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    dropdown(): FluentFiltersOrRelationsGetter;
+    text(): FluentFiltersOrRelationsGetter;
     /**
-     * Filters for an UI element 'icon'.
+     * Filters for a UI element 'icon'.
      *
-     * You can combine it with the 'withText' command to look for a specific icon.
+     * You can combine it with the element-description 'withText()' to look for a specific icon.
      *
      * **Examples:**
      * ```typescript
      * icon().withText('plus')
      * ```
      *
-     * Note: This is an alpha feature. The prediction of the icon name is sometimes unstable. Use custom elements as an alternative.
+     * **Note:** This is an alpha feature. The prediction of the icon name is sometimes unstable. Use custom elements as an alternative.
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
     icon(): FluentFiltersOrRelationsGetter;
     /**
-     * Filters for a custom UI element (see {@link CustomElementJson}).
+     * Filters for a 'custom element', that is a UI element which is defined by providing an image and other parameters such as degree of rotation. It allows filtering for a UI element that is not recognized by our machine learning models by default. It can also be used for pixel assertions of elements using classical [template matching](https://en.wikipedia.org/wiki/Template_matching).
+     *
+     * **Example**
+     * ```typescript
+     * await aui
+     *     .click()
+     *     .customElement({
+     *         customImage: './logo.png', // required
+     *         name: 'myLogo', // optional
+     *         threshold: 0.9, // optional, defaults to 0.9
+     *         rotationDegreePerStep: 0, // optional, defaults to 0
+     *         imageCompareFormat: 'grayscale', // optional, defaults to 'grayscale'
+     *         // mask:{x:0, y:0}[] // optional, a polygon to match only a certain area of the custom element
+     *     })
+     *     .exec();
+     * ```
+     *
+     * **Arguments**
+     *
+     * - **customImage** (*`string`, required*):
+     *     - A cropped image in the form of a base64 string or file path.
+     * - **name** (*`string`, optional*):
+     *     - A unique name that can be used for filtering for the custom element. If not given, any text inside the custom image will be detected via OCR.
+     * - **threshold** (*`number`, optional*):
+     *     - A threshold for how much a UI element needs to be similar to the custom element as defined. Takes values between `0.0` (== all elements are recognized as the custom element which is probably not what you want) and `1.0` (== elements need to look exactly like the `customImage` which is unlikely to be achieved as even minor differences count). Defaults to `0.9`.
+     * - **rotationDegreePerStep** (*`number`, optional*):
+     *     - Step size in rotation degree. Rotates the custom image by this step size until 360° is exceeded. The range is from `0` to `360`. Defaults to `0`.
+     * - **imageCompareFormat** (*`'RGB' | 'grayscale'`, optional*):
+     *     - The color compare style. 'greyscale' compares the brightness of each pixel whereas 'RGB' compares all three color. Defaults to 'grayscale'.
+     * of the given custom image.
      *
-     * **Important**: This increases the runtime quite a bit. So
-     *  only use it when absolutely necessary.
      *
      * @param {CustomElementJson} customElement - The custom element to filter for.
      *
@@ -2324,11 +1548,37 @@ export declare class FluentFiltersGetter extends FluentBase {
      */
     customElement(customElement: CustomElementJson): FluentFiltersOrRelationsGetter;
     /**
-     * Filters for a UI element 'checkbox' checked or unchecked.
+     * Filters for a UI element 'image'.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Works if there is only one image visible on the screen
+     * await aui.click().image().exec();
+     *
+     * // Works if you have an image with
+     * // a caption text below
+     * await aui.click().image().above().text().withText('The caption').exec();
+     * ```
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    checkbox(): FluentFiltersOrRelationsGetter;
+    image(): FluentFiltersOrRelationsGetter;
+    /**
+     * Filters for a UI element 'textfield'.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Works if there is only one textfield visible on the screen
+     * await aui.typeIn('Oh yeah').textfield().exec();
+     *
+     * // Works if you have a labeled textfield
+     * // Label is above the textfield
+     * await aui.typeIn('Oh yeah').textfield().below().text().withText('E-Mail Address').exec();
+     * ```
+     *
+     * @return {FluentFiltersOrRelationsGetter}
+     */
+    textfield(): FluentFiltersOrRelationsGetter;
     /**
      * Filters for similar (doesn't need to be a 100% equal) text.
      *
@@ -2397,9 +1647,9 @@ export declare class FluentFiltersGetter extends FluentBase {
      *
      * **Examples:**
      * ```typescript
-     * 'This is an text' === containsText('text') => true
-     * 'This is an text' === containsText('other text') => false
-     * 'This is an text' === containsText('other') => false
+     * 'This is a text' === containsText('text') => true
+     * 'This is a text' === containsText('other text') => false
+     * 'This is a text' === containsText('other') => false
      * ```
      * ![](https://docs.askui.com/img/gif/containsText.gif)
      *
@@ -2408,6 +1658,14 @@ export declare class FluentFiltersGetter extends FluentBase {
      * @return {FluentFiltersOrRelationsGetter}
      */
     containsText(text: string): FluentFiltersOrRelationsGetter;
+    /**
+     * Filters elements based on a textual description.
+     *
+     * @param {string} text - A description of the target element.
+     *
+     * @return {FluentFiltersOrRelationsGetter}
+     */
+    matching(text: string): FluentFiltersOrRelationsGetter;
 }
 export declare class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
     /**
@@ -2427,7 +1685,7 @@ export declare class FluentFiltersOrRelationsGetter extends FluentFiltersGetter
      *
      * ```
      * In case, that your reference element can have multiple values, in the following example, the element right of the button can be either icon or text.
-     * You can use **the `or()` relation**, so your teststep is valid for both scenes
+     * You can use **the `or()` relation**, so your instruction is valid for both scenes
      * ```typescript
      * const button = await aui.get().button().rightOf().icon().or().text().exec();
      * console.log(button);
@@ -2459,12 +1717,13 @@ export declare class FluentFiltersOrRelationsGetter extends FluentFiltersGetter
      * example scene:
      *  ---------------   ----------------
      *  |  icon user  |   |  icon search |
-     *  ---------------   ---------------n```
+     *  ---------------   ----------------
+     * ```
      * ```typescript
      * const icons = await aui.get().icon().exec();
      * console.log(icons);
      * ```
-     * Using only the filter icon, the get command will return both icons
+     * Using only the element-description icon, the get will return both icons
      * ```text
      * console output: [
      *   DetectedElement {
@@ -2489,12 +1748,12 @@ export declare class FluentFiltersOrRelationsGetter extends FluentFiltersGetter
      *   }
      *  ]
      * ```
-     * You can combine filters with **the `and()` relation** and specify exactly which icon you want
+     * You can combine element-descriptions with **the `and()` relation** and specify exactly which icon you want.
      * ```typescript
      * const icons = await aui.get().icon().and().withText('user').exec()
      * console.log(icons)
      * ```
-     * The get command returns only the user icon although both elements are icons
+     * The get returns only the user icon although both elements are icons.
      * ```text
      *  console output: [
      *   DetectedElement {
@@ -2698,7 +1957,7 @@ export declare abstract class Getter extends FluentCommand {
      *         xmax: 1178.8204241071428,
      *         ymax: 180.83512834821428
      *      }
-     *  }
+     *    }
      *  ]
      * ```
      *
@@ -2738,7 +1997,7 @@ export declare abstract class Getter extends FluentCommand {
      *         ymax: 950.47812834821428
      *      },
      *      ... 381 more items
-     *  }
+     *    }
      *  ]
      * ```
      *