askui 0.7.2 → 0.9.0

package/dist/cjs/execution/dsl.js

@@ -63,1795 +63,287 @@ exports.Exec = Exec;
 // Filters
 class FluentFilters extends FluentBase {
     /**
-     * Filters for a UI element 'wizard item active'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    wizardItemActive() {
-        this._textStr = 'wizard item active';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'wizard item'.
+     * Filters for a UI element 'table'.
      *
      * @return {FluentFiltersOrRelations}
      */
-    wizardItem() {
-        this._textStr = 'wizard item';
+    table() {
+        this._textStr = 'table';
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'wizard'.
+     * Filters for a UI element 'switch'.
      *
      * @return {FluentFiltersOrRelations}
      */
-    wizard() {
-        this._textStr = 'wizard';
+    switch() {
+        this._textStr = 'switch';
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'windows bar'.
+     * Filters for a UI element 'container'.
      *
      * @return {FluentFiltersOrRelations}
      */
-    windowsBar() {
-        this._textStr = 'windows bar';
+    container() {
+        this._textStr = 'container';
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'window'.
+     * Filters for a UI element 'checkbox'.
      *
      * @return {FluentFiltersOrRelations}
      */
-    window() {
-        this._textStr = 'window';
+    checkbox() {
+        this._textStr = 'checkbox';
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'video'.
+     * Filters for a UI element 'button'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    video() {
-        this._textStr = 'video';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'url'.
+     * **Examples:**
+     * ```typescript
+     * await aui.moveMouseTo().button().exec()
+     * ```
      *
      * @return {FluentFiltersOrRelations}
      */
-    url() {
-        this._textStr = 'url';
+    button() {
+        this._textStr = 'button';
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'tooltip'.
+     * Filters for an UI element 'text'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    tooltip() {
-        this._textStr = 'tooltip';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'textfield'.
+     * Often combined with the filter `withText()` as shown in the below examples.
+     * See also the filters `withTextRegex()` and `withExactText()`
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    textfield() {
-        this._textStr = 'textfield';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'textarea'.
+     * **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}
      */
-    textarea() {
-        this._textStr = 'textarea';
+    text() {
+        this._textStr = 'text';
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'table row'.
+     * Filters for a UI element 'icon'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    tableRow() {
-        this._textStr = 'table row';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'table header'.
+     * You can combine it with the element-description 'withText()' to look for a specific icon.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    tableHeader() {
-        this._textStr = 'table header';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'table column'.
+     * **Examples:**
+     * ```typescript
+     * icon().withText('plus')
+     * ```
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    tableColumn() {
-        this._textStr = 'table column';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'table'.
+     * **Note:** This is an alpha feature. The prediction of the icon name is sometimes unstable. Use custom elements as an alternative.
      *
      * @return {FluentFiltersOrRelations}
      */
-    table() {
-        this._textStr = 'table';
+    icon() {
+        this._textStr = 'icon';
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'tab selected'.
+     * 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}
-     */
-    tabSelected() {
-        this._textStr = 'tab selected';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'tab bar'.
+     * **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}
-     */
-    tabBar() {
-        this._textStr = 'tab bar';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'tab active'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    tabActive() {
-        this._textStr = 'tab active';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'tab'.
+     * @param {CustomElementJson} customElement - The custom element to filter for.
      *
      * @return {FluentFiltersOrRelations}
      */
-    tab() {
-        this._textStr = 'tab';
+    customElement(customElement) {
+        this._textStr = 'custom element';
+        this._params.set('customElement', customElement);
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'switch enabled'.
+     * Filters for a UI element 'image'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    switchEnabled() {
-        this._textStr = 'switch enabled';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'switch disabled'.
+     * **Examples:**
+     * ```typescript
+     * // Works if there is only one image visible on the screen
+     * await aui.click().image().exec();
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    switchDisabled() {
-        this._textStr = 'switch disabled';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'status bar'.
+     * // Works if you have an image with
+     * // a caption text below
+     * await aui.click().image().above().text().withText('The caption').exec();
+     * ```
      *
      * @return {FluentFiltersOrRelations}
      */
-    statusBar() {
-        this._textStr = 'status bar';
+    image() {
+        this._textStr = 'image';
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'slider indicator'.
+     * Filters for a UI element 'textfield'.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    sliderIndicator() {
-        this._textStr = 'slider indicator';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'slider'.
+     * **Examples:**
+     * ```typescript
+     * // Works if there is only one textfield visible on the screen
+     * await aui.typeIn('Oh yeah').textfield().exec();
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    slider() {
-        this._textStr = 'slider';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'sidebar'.
+     * // 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}
      */
-    sidebar() {
-        this._textStr = 'sidebar';
+    textfield() {
+        this._textStr = 'textfield';
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'scroll bar'.
+     * Filters for similar (doesn't need to be a 100% equal) text.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    scrollBar() {
-        this._textStr = 'scroll bar';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'rect'.
+     * **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}
-     */
-    rect() {
-        this._textStr = 'rect';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'recaptcha'.
+     * // usually false
+     * 'atebxtc' === withText('text') => false
+     * 'other' === withText('text') => false
+     * ```
+     * ![](https://docs.askui.com/img/gif/withText.gif)
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    recaptcha() {
-        this._textStr = 'recaptcha';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'rate'.
+     * @param {string} text - A text to be matched.
      *
      * @return {FluentFiltersOrRelations}
      */
-    rate() {
-        this._textStr = 'rate';
+    withText(text) {
+        this._textStr = `with text ${Separators.STRING}${text}${Separators.STRING}`;
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'radio button unselected'.
+     * Filters for texts, which match the regex pattern.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    radioButtonUnselected() {
-        this._textStr = 'radio button unselected';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'radio button selected'.
+     * **Examples:**
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    radioButtonSelected() {
-        this._textStr = 'radio button selected';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'progressbar'.
+     * ```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}
-     */
-    progressbar() {
-        this._textStr = 'progressbar';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'progress bar'.
+     * await aui.get().text().withTextRegex('\b[Ss]\w+').exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    progressBar() {
-        this._textStr = 'progress bar';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'popover'.
+     * @param {string} regex_pattern - A regex pattern
      *
      * @return {FluentFiltersOrRelations}
      */
-    popover() {
-        this._textStr = 'popover';
+    withTextRegex(regex_pattern) {
+        this._textStr = `match regex pattern ${Separators.STRING}${regex_pattern}${Separators.STRING}`;
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'pil'.
+     * Filters for equal text.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    pil() {
-        this._textStr = 'pil';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'password'.
+     * **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}
-     */
-    password() {
-        this._textStr = 'password';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'pager'.
+     * **Examples:**
+     * ```typescript
+     * 'text' === withExactText('text') => true
+     * 'test' === withExactText('text') => false
+     * 'other' === withExactText('text') => false
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    pager() {
-        this._textStr = 'pager';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'navigation bar'.
+     * await aui.moveMouseTo().text().withExactText('Password').exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    navigationBar() {
-        this._textStr = 'navigation bar';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'mouse text'.
+     * @param {string} text - A text to be matched.
      *
      * @return {FluentFiltersOrRelations}
      */
-    mouseText() {
-        this._textStr = 'mouse text';
+    withExactText(text) {
+        this._textStr = `equals text ${Separators.STRING}${text}${Separators.STRING}`;
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'mouse pointer'.
+     * Filters for text containing the text provided as an argument.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    mousePointer() {
-        this._textStr = 'mouse pointer';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'mouse cursor'.
+     * **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}
-     */
-    mouseCursor() {
-        this._textStr = 'mouse cursor';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'modal'.
+     * @param {string} text - A text to be matched.
      *
      * @return {FluentFiltersOrRelations}
      */
-    modal() {
-        this._textStr = 'modal';
+    containsText(text) {
+        this._textStr = `contain text ${Separators.STRING}${text}${Separators.STRING}`;
         return new FluentFiltersOrRelations(this);
     }
     /**
-     * Filters for a UI element 'message box'.
+     * Filters elements based on a textual description.
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    messageBox() {
-        this._textStr = 'message box';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'map'.
+     * @param {string} text - A description of the target element.
      *
      * @return {FluentFiltersOrRelations}
      */
-    map() {
-        this._textStr = 'map';
+    matching(text) {
+        this._textStr = `matching ${Separators.STRING}${text}${Separators.STRING}`;
         return new FluentFiltersOrRelations(this);
     }
+}
+exports.FluentFilters = FluentFilters;
+// Relations
+class FluentFiltersOrRelations extends FluentFilters {
     /**
-     * Filters for a UI element 'logo'.
+     * Logic or operator
      *
-     * @return {FluentFiltersOrRelations}
-     */
-    logo() {
-        this._textStr = 'logo';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'link'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    link() {
-        this._textStr = 'link';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'keyboard'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    keyboard() {
-        this._textStr = 'keyboard';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'image'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    image() {
-        this._textStr = 'image';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'header'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    header() {
-        this._textStr = 'header';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'footer'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    footer() {
-        this._textStr = 'footer';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'flag'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    flag() {
-        this._textStr = 'flag';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'dropdown menu'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    dropdownMenu() {
-        this._textStr = 'dropdown menu';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'divider'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    divider() {
-        this._textStr = 'divider';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'circle'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    circle() {
-        this._textStr = 'circle';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'checkbox unchecked'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    checkboxUnchecked() {
-        this._textStr = 'checkbox unchecked';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'checkbox checked'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    checkboxChecked() {
-        this._textStr = 'checkbox checked';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'chart pie'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    chartPie() {
-        this._textStr = 'chart pie';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'chart'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    chart() {
-        this._textStr = 'chart';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'card'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    card() {
-        this._textStr = 'card';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'browser bar'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    browserBar() {
-        this._textStr = 'browser bar';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'breadcrumb'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    breadcrumb() {
-        this._textStr = 'breadcrumb';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'banner'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    banner() {
-        this._textStr = 'banner';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'badge'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    badge() {
-        this._textStr = 'badge';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'alert'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    alert() {
-        this._textStr = 'alert';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'unknown'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    unknown() {
-        this._textStr = 'unknown';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for an UI element 'button'.
-     *
-     * **Examples:**
-     * ```typescript
-     * await aui.moveMouseTo().button().exec()
-     * ```
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    button() {
-        this._textStr = 'button';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for an UI element 'text'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    text() {
-        this._textStr = 'text';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for an UI element 'dropdown'.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    dropdown() {
-        this._textStr = 'dropdown';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * 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() {
-        this._textStr = 'icon';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * 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) {
-        this._textStr = 'custom element';
-        this._params.set('customElement', customElement);
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * Filters for a UI element 'checkbox' checked or unchecked.
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    checkbox() {
-        this._textStr = 'checkbox';
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * 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) {
-        this._textStr = `with text ${Separators.STRING}${text}${Separators.STRING}`;
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * 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) {
-        this._textStr = `match regex pattern ${Separators.STRING}${regex_pattern}${Separators.STRING}`;
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * 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) {
-        this._textStr = `equals text ${Separators.STRING}${text}${Separators.STRING}`;
-        return new FluentFiltersOrRelations(this);
-    }
-    /**
-     * 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) {
-        this._textStr = `contain text ${Separators.STRING}${text}${Separators.STRING}`;
-        return new FluentFiltersOrRelations(this);
-    }
-}
-exports.FluentFilters = FluentFilters;
-// Relations
-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() {
-        this._textStr = 'or';
-        return new FluentFilters(this);
-    }
-    /**
-     * 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
-     * ```text
-     * console output: [
-     *   DetectedElement {
-     *      name: 'ICON',
-     *      text: 'user',
-     *      bndbox: BoundingBox {
-     *         xmin: 1000,
-     *         ymin: 1010,
-     *         xmax: 1020,
-     *         ymax: 1030
-     *      }
-     *   },
-     *   DetectedElement {
-     *      name: 'ICON',
-     *      text: 'search',
-     *      bndbox: BoundingBox {
-     *         xmin: 900,
-     *         ymin: 910,
-     *         xmax: 920,
-     *         ymax: 930
-     *      }
-     *   }
-     *  ]
-     * ```
-     * You can combine filters 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
-     * ```text
-     *  console output: [
-     *   DetectedElement {
-     *      name: 'ICON',
-     *      text: 'user',
-     *      bndbox: BoundingBox {
-     *         xmin: 900,
-     *         ymin: 910,
-     *         xmax: 920,
-     *         ymax: 930
-     *      }
-     *   }
-     *  ]
-     * ```
-     *
-     * @return {FluentFilters}
-     */
-    and() {
-        this._textStr = 'and';
-        return new FluentFilters(this);
-    }
-    /**
-     * Filters for an element inside another element.
-     *
-     * **Examples:**
-     * ```typescript
-     * --------------------
-     * |     outerEl      |
-     * |  --------------  |
-     * |  |  innerEl   |  |
-     * |  --------------  |
-     * |                  |
-     * --------------------
-     *
-     * // Returns innerEl because innerEl is inside outerEl
-     * ...innerEl().in().outerEl()
-     * // Returns nothing because innerEl is not inside outerEl
-     * ...outerEl().in().innerEl()
-     * ```
-     * ![](https://docs.askui.com/img/gif/in.gif)
-     *
-     * @return {FluentFilters}
-     */
-    in() {
-        this._textStr = 'in';
-        return new FluentFilters(this);
-    }
-    /**
-     * Filters for an element right of another element.
-     *
-     * **Examples:**
-     * ```typescript
-     * --------------  --------------
-     * |  leftEl    |  |  rightEl   |
-     * --------------  --------------
-     *
-     * // Returns rightEl because rightEl is right of leftEl
-     * ...rightEl().rightOf().leftEl()
-     * // Returns no element because leftEl is left of rightEl
-     * ...leftEl().rightOf().rightEl()
-     * ```
-     * ![](https://docs.askui.com/img/gif/rightOf.gif)
-     *
-     * @return {FluentFilters}
-     */
-    rightOf() {
-        this._textStr = 'right of';
-        return new FluentFilters(this);
-    }
-    /**
-     * Filters for an element left of another element.
-     *
-     * **Examples:**
-     * ```typescript
-     * --------------  --------------
-     * |  leftEl    |  |  rightEl   |
-     * --------------  --------------
-     *
-     * // Returns leftEl because leftEl is left of rightEl
-     * ...leftEl().leftOf().rightEl()
-     * // Returns no element because rightEl is left of leftEl
-     * ...rightEl().leftOf().leftEl()
-     * ```
-     * ![](https://docs.askui.com/img/gif/leftOf.gif)
-     *
-     * @return {FluentFilters}
-     */
-    leftOf() {
-        this._textStr = 'left of';
-        return new FluentFilters(this);
-    }
-    /**
-     * Filters for an element below another element.
-     *
-     * **Examples:**
-     * ```typescript
-     * --------------
-     * |    text    |
-     * --------------
-     * --------------
-     * |   button   |
-     * --------------
-     *
-     * // Returns button because button is below text
-     * ...button().below().text()
-     * // Returns no element because text is above button
-     * ...text().below().button()
-     * ```
-     * ![](https://docs.askui.com/img/gif/below.gif)
-     *
-     * @return {FluentFilters}
-     */
-    below() {
-        this._textStr = 'below';
-        return new FluentFilters(this);
-    }
-    /**
-     * Filters for an element above another element.
-     *
-     * **Examples:**
-     * ```typescript
-     * --------------
-     * |    text    |
-     * --------------
-     * --------------
-     * |   button   |
-     * --------------
-     *
-     * // Returns text because text is above button
-     * ...text().above().button()
-     * // Returns no element because button is below text
-     * ...button().above().text()
-     * ```
-     * ![](https://docs.askui.com/img/gif/above.gif)
-     *
-     * @return {FluentFilters}
-     */
-    above() {
-        this._textStr = 'above';
-        return new FluentFilters(this);
-    }
-    /**
-     * Filters for an element nearest to another element.
-     *
-     * **Examples:**
-     * ```typescript
-     * --------------
-     * |  button 1  |
-     * --------------
-     * --------------
-     * |   text     |
-     * --------------
-     *
-     *
-     *
-     * --------------
-     * |  button 2  |
-     * --------------
-     *
-     * // Returns button 1 because button 1 is nearer to the text than button 2
-     * ...button().nearestTo().text()
-     * ```
-     * ![](https://docs.askui.com/img/gif/nearestTo.gif)
-     *
-     * @return {FluentFilters}
-     */
-    nearestTo() {
-        this._textStr = 'nearest to';
-        return new FluentFilters(this);
-    }
-    /**
-     * 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() {
-        this._textStr = 'contains';
-        return new FluentFilters(this);
-    }
-    exec() {
-        return this.fluentCommandStringBuilder();
-    }
-}
-exports.FluentFiltersOrRelations = FluentFiltersOrRelations;
-// Filters
-class FluentFiltersCondition extends FluentBase {
-    /**
-     * Filters for a UI element 'wizard item active'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    wizardItemActive() {
-        this._textStr = 'wizard item active';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'wizard item'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    wizardItem() {
-        this._textStr = 'wizard item';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'wizard'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    wizard() {
-        this._textStr = 'wizard';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'windows bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    windowsBar() {
-        this._textStr = 'windows bar';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'window'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    window() {
-        this._textStr = 'window';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'video'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    video() {
-        this._textStr = 'video';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'url'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    url() {
-        this._textStr = 'url';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'tooltip'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tooltip() {
-        this._textStr = 'tooltip';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'textfield'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    textfield() {
-        this._textStr = 'textfield';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'textarea'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    textarea() {
-        this._textStr = 'textarea';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'table row'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tableRow() {
-        this._textStr = 'table row';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'table header'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tableHeader() {
-        this._textStr = 'table header';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'table column'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tableColumn() {
-        this._textStr = 'table column';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'table'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    table() {
-        this._textStr = 'table';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'tab selected'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tabSelected() {
-        this._textStr = 'tab selected';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'tab bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tabBar() {
-        this._textStr = 'tab bar';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'tab active'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tabActive() {
-        this._textStr = 'tab active';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'tab'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    tab() {
-        this._textStr = 'tab';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'switch enabled'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    switchEnabled() {
-        this._textStr = 'switch enabled';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'switch disabled'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    switchDisabled() {
-        this._textStr = 'switch disabled';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'status bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    statusBar() {
-        this._textStr = 'status bar';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'slider indicator'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    sliderIndicator() {
-        this._textStr = 'slider indicator';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'slider'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    slider() {
-        this._textStr = 'slider';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'sidebar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    sidebar() {
-        this._textStr = 'sidebar';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'scroll bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    scrollBar() {
-        this._textStr = 'scroll bar';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'rect'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    rect() {
-        this._textStr = 'rect';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'recaptcha'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    recaptcha() {
-        this._textStr = 'recaptcha';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'rate'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    rate() {
-        this._textStr = 'rate';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'radio button unselected'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    radioButtonUnselected() {
-        this._textStr = 'radio button unselected';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'radio button selected'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    radioButtonSelected() {
-        this._textStr = 'radio button selected';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'progressbar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    progressbar() {
-        this._textStr = 'progressbar';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'progress bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    progressBar() {
-        this._textStr = 'progress bar';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'popover'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    popover() {
-        this._textStr = 'popover';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'pil'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    pil() {
-        this._textStr = 'pil';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'password'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    password() {
-        this._textStr = 'password';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'pager'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    pager() {
-        this._textStr = 'pager';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'navigation bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    navigationBar() {
-        this._textStr = 'navigation bar';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'mouse text'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    mouseText() {
-        this._textStr = 'mouse text';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'mouse pointer'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    mousePointer() {
-        this._textStr = 'mouse pointer';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'mouse cursor'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    mouseCursor() {
-        this._textStr = 'mouse cursor';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'modal'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    modal() {
-        this._textStr = 'modal';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'message box'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    messageBox() {
-        this._textStr = 'message box';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'map'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    map() {
-        this._textStr = 'map';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'logo'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    logo() {
-        this._textStr = 'logo';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'link'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    link() {
-        this._textStr = 'link';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'keyboard'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    keyboard() {
-        this._textStr = 'keyboard';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'image'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    image() {
-        this._textStr = 'image';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'header'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    header() {
-        this._textStr = 'header';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'footer'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    footer() {
-        this._textStr = 'footer';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'flag'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    flag() {
-        this._textStr = 'flag';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'dropdown menu'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    dropdownMenu() {
-        this._textStr = 'dropdown menu';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'divider'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    divider() {
-        this._textStr = 'divider';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'circle'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    circle() {
-        this._textStr = 'circle';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'checkbox unchecked'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    checkboxUnchecked() {
-        this._textStr = 'checkbox unchecked';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'checkbox checked'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    checkboxChecked() {
-        this._textStr = 'checkbox checked';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'chart pie'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    chartPie() {
-        this._textStr = 'chart pie';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'chart'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    chart() {
-        this._textStr = 'chart';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'card'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    card() {
-        this._textStr = 'card';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'browser bar'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    browserBar() {
-        this._textStr = 'browser bar';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'breadcrumb'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    breadcrumb() {
-        this._textStr = 'breadcrumb';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'banner'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    banner() {
-        this._textStr = 'banner';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'badge'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    badge() {
-        this._textStr = 'badge';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'alert'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    alert() {
-        this._textStr = 'alert';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'unknown'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    unknown() {
-        this._textStr = 'unknown';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for an UI element 'button'.
-     *
-     * **Examples:**
-     * ```typescript
-     * await aui.moveMouseTo().button().exec()
-     * ```
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    button() {
-        this._textStr = 'button';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for an UI element 'text'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    text() {
-        this._textStr = 'text';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for an UI element 'dropdown'.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    dropdown() {
-        this._textStr = 'dropdown';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * 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 {FluentFiltersOrRelationsCondition}
-     */
-    icon() {
-        this._textStr = 'icon';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * 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 {FluentFiltersOrRelationsCondition}
-     */
-    customElement(customElement) {
-        this._textStr = 'custom element';
-        this._params.set('customElement', customElement);
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * Filters for a UI element 'checkbox' checked or unchecked.
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    checkbox() {
-        this._textStr = 'checkbox';
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * 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 {FluentFiltersOrRelationsCondition}
-     */
-    withText(text) {
-        this._textStr = `with text ${Separators.STRING}${text}${Separators.STRING}`;
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * 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 {FluentFiltersOrRelationsCondition}
-     */
-    withTextRegex(regex_pattern) {
-        this._textStr = `match regex pattern ${Separators.STRING}${regex_pattern}${Separators.STRING}`;
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * 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 {FluentFiltersOrRelationsCondition}
-     */
-    withExactText(text) {
-        this._textStr = `equals text ${Separators.STRING}${text}${Separators.STRING}`;
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-    /**
-     * 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 {FluentFiltersOrRelationsCondition}
-     */
-    containsText(text) {
-        this._textStr = `contain text ${Separators.STRING}${text}${Separators.STRING}`;
-        return new FluentFiltersOrRelationsCondition(this);
-    }
-}
-exports.FluentFiltersCondition = FluentFiltersCondition;
-// Relations
-class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
-    /**
-     * Logic or operator
-     *
-     * **Examples:**
-     * ```text
-     * scene 1
-     * --------------  ---------------
-     * |  button    |  |  icon       |
-     * --------------  ---------------
+     * **Examples:**
+     * ```text
+     * scene 1
+     * --------------  ---------------
+     * |  button    |  |  icon       |
+     * --------------  ---------------
      *
      * scene 2
      * --------------  ---------------
@@ -1860,7 +352,7 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      *
      * ```
      * 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);
@@ -1881,11 +373,11 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      *  ]
      * ```
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFilters}
      */
     or() {
         this._textStr = 'or';
-        return new FluentFiltersCondition(this);
+        return new FluentFilters(this);
     }
     /**
      * Logic and operator
@@ -1895,12 +387,13 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * 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 {
@@ -1925,12 +418,12 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      *   }
      *  ]
      * ```
-     * 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 {
@@ -1946,11 +439,11 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      *  ]
      * ```
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFilters}
      */
     and() {
         this._textStr = 'and';
-        return new FluentFiltersCondition(this);
+        return new FluentFilters(this);
     }
     /**
      * Filters for an element inside another element.
@@ -1972,11 +465,11 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * ```
      * ![](https://docs.askui.com/img/gif/in.gif)
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFilters}
      */
     in() {
         this._textStr = 'in';
-        return new FluentFiltersCondition(this);
+        return new FluentFilters(this);
     }
     /**
      * Filters for an element right of another element.
@@ -1994,11 +487,11 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * ```
      * ![](https://docs.askui.com/img/gif/rightOf.gif)
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFilters}
      */
     rightOf() {
         this._textStr = 'right of';
-        return new FluentFiltersCondition(this);
+        return new FluentFilters(this);
     }
     /**
      * Filters for an element left of another element.
@@ -2016,11 +509,11 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * ```
      * ![](https://docs.askui.com/img/gif/leftOf.gif)
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFilters}
      */
     leftOf() {
         this._textStr = 'left of';
-        return new FluentFiltersCondition(this);
+        return new FluentFilters(this);
     }
     /**
      * Filters for an element below another element.
@@ -2041,11 +534,11 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * ```
      * ![](https://docs.askui.com/img/gif/below.gif)
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFilters}
      */
     below() {
         this._textStr = 'below';
-        return new FluentFiltersCondition(this);
+        return new FluentFilters(this);
     }
     /**
      * Filters for an element above another element.
@@ -2066,11 +559,11 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * ```
      * ![](https://docs.askui.com/img/gif/above.gif)
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFilters}
      */
     above() {
         this._textStr = 'above';
-        return new FluentFiltersCondition(this);
+        return new FluentFilters(this);
     }
     /**
      * Filters for an element nearest to another element.
@@ -2095,11 +588,11 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * ```
      * ![](https://docs.askui.com/img/gif/nearestTo.gif)
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFilters}
      */
     nearestTo() {
         this._textStr = 'nearest to';
-        return new FluentFiltersCondition(this);
+        return new FluentFilters(this);
     }
     /**
      * Filters for an element containing another element.
@@ -2121,986 +614,1152 @@ class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * ```
      * ![](https://docs.askui.com/img/gif/contains.gif)
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFilters}
      */
     contains() {
         this._textStr = 'contains';
-        return new FluentFiltersCondition(this);
+        return new FluentFilters(this);
+    }
+    exec() {
+        return this.fluentCommandStringBuilder();
     }
+}
+exports.FluentFiltersOrRelations = FluentFiltersOrRelations;
+// Filters
+class FluentFiltersCondition extends FluentBase {
     /**
-     * Expects that filtered element exists.
+     * Filters for a UI element 'table'.
      *
-     * **Examples:**
-     * ```typescript
-     * await aui.expect().text().withText('Login').exists().exec()
-     * ```
+     * @return {FluentFiltersOrRelationsCondition}
+     */
+    table() {
+        this._textStr = 'table';
+        return new FluentFiltersOrRelationsCondition(this);
+    }
+    /**
+     * Filters for a UI element 'switch'.
      *
-     * @return {ExecCondition}
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    exists() {
-        this._textStr = 'exists';
-        return new ExecCondition(this);
+    switch() {
+        this._textStr = 'switch';
+        return new FluentFiltersOrRelationsCondition(this);
+    }
+    /**
+     * Filters for a UI element 'container'.
+     *
+     * @return {FluentFiltersOrRelationsCondition}
+     */
+    container() {
+        this._textStr = 'container';
+        return new FluentFiltersOrRelationsCondition(this);
+    }
+    /**
+     * Filters for a UI element 'checkbox'.
+     *
+     * @return {FluentFiltersOrRelationsCondition}
+     */
+    checkbox() {
+        this._textStr = 'checkbox';
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Expects that filtered element does not exist.
+     * Filters for a UI element 'button'.
      *
      * **Examples:**
      * ```typescript
-     * await aui.expect().text().withText('Login').notExists().exec()
+     * await aui.moveMouseTo().button().exec()
      * ```
      *
-     * @return {ExecCondition}
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    notExists() {
-        this._textStr = 'not exists';
-        return new ExecCondition(this);
-    }
-}
-exports.FluentFiltersOrRelationsCondition = FluentFiltersOrRelationsCondition;
-class ExecCondition extends Exec {
-}
-// Commands
-class FluentCommand extends FluentBase {
-    constructor() {
-        super(undefined);
+    button() {
+        this._textStr = 'button';
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Expects a condition, e.g., `exists()` or `notExits()`.
+     * Filters for an UI element 'text'.
+     *
+     * Often combined with the filter `withText()` as shown in the below examples.
+     * See also the filters `withTextRegex()` and `withExactText()`
      *
      * **Examples:**
      * ```typescript
-     * await aui.expect().text().withText('Login').exists().exec()
-     * await aui.expect().text().withText('Login').notExists().exec()
+     * await aui.click().text().withText('Password').exec();
+     * await aui.click().text().withExactText('Username').exec();
+     * await aui.click().text().withTextRegex('\b[Ss]\w+').exec();
      * ```
      *
-     * @return {FluentFiltersCondition}
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    expect() {
-        this._textStr = 'Expect';
-        return new FluentFiltersCondition(this);
+    text() {
+        this._textStr = 'text';
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Clicks on the filtered element.
+     * Filters for a UI element 'icon'.
      *
-     * **Example:**
+     * You can combine it with the element-description 'withText()' to look for a specific icon.
+     *
+     * **Examples:**
      * ```typescript
-     * await aui.click().button().withText('Submit').exec()
+     * icon().withText('plus')
      * ```
      *
-     * @return {FluentFilters}
+     * **Note:** This is an alpha feature. The prediction of the icon name is sometimes unstable. Use custom elements as an alternative.
+     *
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    click() {
-        this._textStr = 'Click on';
-        return new FluentFilters(this);
+    icon() {
+        this._textStr = 'icon';
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Move mouse over the filtered element.
+     * 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:**
+     * **Example**
      * ```typescript
-     * await aui.moveMouseTo().button().withText('Submit').exec()
-     * ```
+     * 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 {FluentFilters}
+     *
+     * @param {CustomElementJson} customElement - The custom element to filter for.
+     *
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    moveMouseTo() {
-        this._textStr = 'Move mouse to';
-        return new FluentFilters(this);
+    customElement(customElement) {
+        this._textStr = 'custom element';
+        this._params.set('customElement', customElement);
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Puts the focus on the filtered element and types in the text.
+     * Filters for a UI element 'image'.
      *
      * **Examples:**
      * ```typescript
-     * await aui.typeIn('Type some text').textfield().exec()
+     * // Works if there is only one image visible on the screen
+     * await aui.click().image().exec();
      *
-     * // mask the text so it is not send to the askui-inference server
-     * await aui.typeIn('Type some text', { isSecret: true, secretMask: '**' }).textfield().exec()
+     * // Works if you have an image with
+     * // a caption text below
+     * await aui.click().image().above().text().withText('The caption').exec();
      * ```
-     * ![](https://docs.askui.com/img/gif/typeIn.gif)
-     *
-     * @param {string} text - A text to type
      *
-     * @return {FluentFilters}
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    typeIn(text) {
-        this._textStr = `Type ${Separators.STRING}${text}${Separators.STRING} in`;
-        return new FluentFilters(this);
+    image() {
+        this._textStr = 'image';
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Moves mouse to the filtered element and scrolls in the x and y direction.
-     *
-     * **macOS**: May not work as expected!
+     * Filters for a UI element 'textfield'.
      *
-     * **Example:**
+     * **Examples:**
      * ```typescript
-     * await aui.scroll(0, 10).textarea().exec()
-     * ```
+     * // Works if there is only one textfield visible on the screen
+     * await aui.typeIn('Oh yeah').textfield().exec();
      *
-     * @param {number} x_offset - A (positive/negative) x direction.
-     * @param {number} y_offset - A (positive/negative) y direction.
+     * // 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 {FluentFilters}
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    scrollInside(x_offset, y_offset) {
-        this._textStr = `Scroll x ${x_offset} y ${y_offset} in`;
-        return new FluentFilters(this);
+    textfield() {
+        this._textStr = 'textfield';
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Moves the mouse relatively to an element in the direction.
-     * This can be used when the mouse should not hover over an element anymore.
+     * Filters for similar (doesn't need to be a 100% equal) text.
      *
      * **Examples:**
      * ```typescript
-     * // Move mouse 30 pixels below button
-     * await aui.moveMouseRelativelyTo(0, 30).button().withText('Submit').exec()
+     * '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/moveMouseRelativelyTo.gif)
+     * ![](https://docs.askui.com/img/gif/withText.gif)
      *
-     * @param {number} x_offset - A (positive/negative) x direction.
-     * @param {number} y_offset - A (positive/negative) y direction.
+     * @param {string} text - A text to be matched.
      *
-     * @return {FluentFilters}
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    moveMouseRelativelyTo(x_offset, y_offset) {
-        this._textStr = `Move mouse x ${x_offset} y ${y_offset} relatively to`;
-        return new FluentFilters(this);
+    withText(text) {
+        this._textStr = `with text ${Separators.STRING}${text}${Separators.STRING}`;
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Swipe an element in the x and y direction.
-     * Holds the left mouse button down on Windows, Linux and macOS and drags the element.
-     * On touch devices it taps the element and then drags it.
+     * Filters for texts, which match the regex pattern.
+     *
+     * **Examples:**
      *
-     * **Example:**
      * ```typescript
-     * // Swipe the element 500 to the right
-     * await aui.swipe(500, 0).image().exec()
+     * '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()
      * ```
-     * ![](https://docs.askui.com/img/gif/swipe.gif)
      *
-     * @param {number} x_offset - A x direction. positive and negative values are accepted
-     * @param {number} y_offset - A y direction. positive and negative values are accepted
+     * @param {string} regex_pattern - A regex pattern
      *
-     * @return {FluentFilters}
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    swipe(x_offset, y_offset) {
-        this._textStr = `Swipe x ${x_offset} y ${y_offset}`;
-        return new FluentFilters(this);
+    withTextRegex(regex_pattern) {
+        this._textStr = `match regex pattern ${Separators.STRING}${regex_pattern}${Separators.STRING}`;
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Types a text at the current position.
-     * If you need to focus the element first, use typeIn()
+     * 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
-     * await aui.type('Type some text').exec()
+     * 'text' === withExactText('text') => true
+     * 'test' === withExactText('text') => false
+     * 'other' === withExactText('text') => false
      *
-     * // mask the text so it is not send to the askui-inference serverawait aui.type('Type some text', { isSecret: true, secretMask: '**' }).exec()
+     * await aui.moveMouseTo().text().withExactText('Password').exec()
      * ```
      *
-     * @param {string} text - A text to type
+     * @param {string} text - A text to be matched.
      *
-     * @return {Exec}
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    type(text) {
-        this._textStr = `Type ${Separators.STRING}${text}${Separators.STRING}`;
-        return new Exec(this);
+    withExactText(text) {
+        this._textStr = `equals text ${Separators.STRING}${text}${Separators.STRING}`;
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Moves the mouse from the current position (relative) in x and y direction.
+     * Filters for text containing the text provided as an argument.
      *
-     * @param {number} x_offset - A (positive/negative) x direction.
-     * @param {number} y_offset - A (positive/negative) y direction.
+     * **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 {Exec}
+     * @param {string} text - A text to be matched.
+     *
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    moveMouseRelatively(x_offset, y_offset) {
-        this._textStr = `Move mouse from current position with x ${x_offset} y ${y_offset}`;
-        return new Exec(this);
+    containsText(text) {
+        this._textStr = `contain text ${Separators.STRING}${text}${Separators.STRING}`;
+        return new FluentFiltersOrRelationsCondition(this);
     }
     /**
-     * Moves the mouse to the absolute x and y coordinates.
+     * Filters elements based on a textual description.
      *
-     * @param {number} x_coordinate - A (positive/negative) x coordinate.
-     * @param {number} y_coordinate - A (positive/negative) y coordinate.
+     * @param {string} text - A description of the target element.
      *
-     * @return {Exec}
+     * @return {FluentFiltersOrRelationsCondition}
      */
-    moveMouse(x_coordinate, y_coordinate) {
-        this._textStr = `Move mouse to x ${x_coordinate} y ${y_coordinate}`;
-        return new Exec(this);
+    matching(text) {
+        this._textStr = `matching ${Separators.STRING}${text}${Separators.STRING}`;
+        return new FluentFiltersOrRelationsCondition(this);
     }
+}
+exports.FluentFiltersCondition = FluentFiltersCondition;
+// Relations
+class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
     /**
-     * Scrolls based on the current mouse position in the x and y direction.
+     * Logic or operator
      *
-     * **Important**: Mouse must be positioned in a scrollable area.
+     * **Examples:**
+     * ```text
+     * scene 1
+     * --------------  ---------------
+     * |  button    |  |  icon       |
+     * --------------  ---------------
      *
-     * **macOS**: May not work as expected!
+     * scene 2
+     * --------------  ---------------
+     * |  button    |  |  text       |
+     * --------------  ---------------
      *
-     * **Example:**
+     * ```
+     * 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
-     * // Scroll 10 up in y direction
-     * await aui.scroll(0, 10).exec()
+     * 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
+     *      }
+     *   }
+     *  ]
      * ```
      *
-     * @param {number} x_offset - A (positive/negative) x direction.
-     * @param {number} y_offset - A (positive/negative) y direction.
-     *
-     * @return {Exec}
+     * @return {FluentFiltersCondition}
      */
-    scroll(x_offset, y_offset) {
-        this._textStr = `Scroll x ${x_offset} y ${y_offset}`;
-        return new Exec(this);
+    or() {
+        this._textStr = 'or';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Executes a shell command on the device.
+     * Logic and operator
      *
-     * **Example:**
+     * **Examples:**
+     * ```text
+     * example scene:
+     *  ---------------   ----------------
+     *  |  icon user  |   |  icon search |
+     *  ---------------   ----------------
+     * ```
      * ```typescript
-     * // Open the lastpass app
-     * await aui.execOnShell('monkey -p com.lastpass.authenticator 1').exec()
+     * const icons = await aui.get().icon().exec();
+     * console.log(icons);
+     * ```
+     * Using only the element-description icon, the get will return both icons
+     * ```text
+     * console output: [
+     *   DetectedElement {
+     *      name: 'ICON',
+     *      text: 'user',
+     *      bndbox: BoundingBox {
+     *         xmin: 1000,
+     *         ymin: 1010,
+     *         xmax: 1020,
+     *         ymax: 1030
+     *      }
+     *   },
+     *   DetectedElement {
+     *      name: 'ICON',
+     *      text: 'search',
+     *      bndbox: BoundingBox {
+     *         xmin: 900,
+     *         ymin: 910,
+     *         xmax: 920,
+     *         ymax: 930
+     *      }
+     *   }
+     *  ]
+     * ```
+     * 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 returns only the user icon although both elements are icons.
+     * ```text
+     *  console output: [
+     *   DetectedElement {
+     *      name: 'ICON',
+     *      text: 'user',
+     *      bndbox: BoundingBox {
+     *         xmin: 900,
+     *         ymin: 910,
+     *         xmax: 920,
+     *         ymax: 930
+     *      }
+     *   }
+     *  ]
      * ```
      *
-     * @param {string} shell_command - A shell command which is executed.
-     *
-     * @return {Exec}
+     * @return {FluentFiltersCondition}
      */
-    execOnShell(shell_command) {
-        this._textStr = `Execute shell command ${Separators.STRING}${shell_command}${Separators.STRING}`;
-        return new Exec(this);
+    and() {
+        this._textStr = 'and';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Clicks with left mouse key.
+     * Filters for an element inside another element.
      *
-     * @return {Exec}
-     */
-    mouseLeftClick() {
-        this._textStr = 'Mouse left click';
-        return new Exec(this);
-    }
-    /**
-     * Clicks with right mouse key.
+     * **Examples:**
+     * ```typescript
+     * --------------------
+     * |     outerEl      |
+     * |  --------------  |
+     * |  |  innerEl   |  |
+     * |  --------------  |
+     * |                  |
+     * --------------------
      *
-     * @return {Exec}
-     */
-    mouseRightClick() {
-        this._textStr = 'Mouse right click';
-        return new Exec(this);
-    }
-    /**
-     * Clicks with middle mouse key.
+     * // Returns innerEl because innerEl is inside outerEl
+     * ...innerEl().in().outerEl()
+     * // Returns nothing because innerEl is not inside outerEl
+     * ...outerEl().in().innerEl()
+     * ```
+     * ![](https://docs.askui.com/img/gif/in.gif)
      *
-     * @return {Exec}
+     * @return {FluentFiltersCondition}
      */
-    mouseMiddleClick() {
-        this._textStr = 'Mouse middle click';
-        return new Exec(this);
+    in() {
+        this._textStr = 'in';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Double-clicks with left mouse key.
+     * Filters for an element right of another element.
      *
-     * @return {Exec}
-     */
-    mouseDoubleLeftClick() {
-        this._textStr = 'Mouse double left click';
-        return new Exec(this);
-    }
-    /**
-     * Double-clicks with right mouse key.
+     * **Examples:**
+     * ```typescript
+     * --------------  --------------
+     * |  leftEl    |  |  rightEl   |
+     * --------------  --------------
      *
-     * @return {Exec}
-     */
-    mouseDoubleRightClick() {
-        this._textStr = 'Mouse double right click';
-        return new Exec(this);
-    }
-    /**
-     * Double-clicks with middle mouse key.
+     * // Returns rightEl because rightEl is right of leftEl
+     * ...rightEl().rightOf().leftEl()
+     * // Returns no element because leftEl is left of rightEl
+     * ...leftEl().rightOf().rightEl()
+     * ```
+     * ![](https://docs.askui.com/img/gif/rightOf.gif)
      *
-     * @return {Exec}
+     * @return {FluentFiltersCondition}
      */
-    mouseDoubleMiddleClick() {
-        this._textStr = 'Mouse double middle click';
-        return new Exec(this);
+    rightOf() {
+        this._textStr = 'right of';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Toggles mouse down (Left mouse key).
+     * Filters for an element left of another element.
      *
-     * @return {Exec}
-     */
-    mouseToggleDown() {
-        this._textStr = 'Mouse toggle down';
-        return new Exec(this);
-    }
-    /**
-     * Toggles mouse up (Left mouse key).
+     * **Examples:**
+     * ```typescript
+     * --------------  --------------
+     * |  leftEl    |  |  rightEl   |
+     * --------------  --------------
      *
-     * @return {Exec}
+     * // Returns leftEl because leftEl is left of rightEl
+     * ...leftEl().leftOf().rightEl()
+     * // Returns no element because rightEl is left of leftEl
+     * ...rightEl().leftOf().leftEl()
+     * ```
+     * ![](https://docs.askui.com/img/gif/leftOf.gif)
+     *
+     * @return {FluentFiltersCondition}
      */
-    mouseToggleUp() {
-        this._textStr = 'Mouse toggle up';
-        return new Exec(this);
+    leftOf() {
+        this._textStr = 'left of';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Press three keys like `CTRL+ALT+DEL`
+     * Filters for an element below another element.
      *
-     * @param {MODIFIER_KEY} first_key - A modifier key
-     * @param {MODIFIER_KEY} second_key - A modifier key
-     * @param {PC_KEY} third_key - A key
+     * **Examples:**
+     * ```typescript
+     * --------------
+     * |    text    |
+     * --------------
+     * --------------
+     * |   button   |
+     * --------------
      *
-     * @return {Exec}
+     * // Returns button because button is below text
+     * ...button().below().text()
+     * // Returns no element because text is above button
+     * ...text().below().button()
+     * ```
+     * ![](https://docs.askui.com/img/gif/below.gif)
+     *
+     * @return {FluentFiltersCondition}
      */
-    pressThreeKeys(first_key, second_key, third_key) {
-        this._textStr = `Press key ${first_key} ${second_key} ${third_key}`;
-        return new Exec(this);
+    below() {
+        this._textStr = 'below';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Press two keys like `ALT+F4`
+     * Filters for an element above another element.
      *
-     * @param {MODIFIER_KEY} first_key - A modifier key
-     * @param {PC_KEY} second_key - A key
+     * **Examples:**
+     * ```typescript
+     * --------------
+     * |    text    |
+     * --------------
+     * --------------
+     * |   button   |
+     * --------------
      *
-     * @return {Exec}
+     * // Returns text because text is above button
+     * ...text().above().button()
+     * // Returns no element because button is below text
+     * ...button().above().text()
+     * ```
+     * ![](https://docs.askui.com/img/gif/above.gif)
+     *
+     * @return {FluentFiltersCondition}
      */
-    pressTwoKeys(first_key, second_key) {
-        this._textStr = `Press key ${first_key} ${second_key}`;
-        return new Exec(this);
+    above() {
+        this._textStr = 'above';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Press one keys like `DEL`
+     * Filters for an element nearest to another element.
      *
-     * @param {PC_AND_MODIFIER_KEY} key - A key
+     * **Examples:**
+     * ```typescript
+     * --------------
+     * |  button 1  |
+     * --------------
+     * --------------
+     * |   text     |
+     * --------------
      *
-     * @return {Exec}
-     */
-    pressKey(key) {
-        this._textStr = `Press key ${key}`;
-        return new Exec(this);
-    }
-    /**
-     * 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, second_key, third_key) {
-        this._textStr = `Press android key ${first_key} ${second_key} ${third_key}`;
-        return new Exec(this);
-    }
-    /**
-     * Press two Android keys like `ALT+F4`
+     * --------------
+     * |  button 2  |
+     * --------------
      *
-     * @param {ANDROID_KEY} first_key - A Android key
-     * @param {ANDROID_KEY} second_key - A Android key
+     * // Returns button 1 because button 1 is nearer to the text than button 2
+     * ...button().nearestTo().text()
+     * ```
+     * ![](https://docs.askui.com/img/gif/nearestTo.gif)
      *
-     * @return {Exec}
+     * @return {FluentFiltersCondition}
      */
-    pressAndroidTwoKey(first_key, second_key) {
-        this._textStr = `Press android key ${first_key} ${second_key}`;
-        return new Exec(this);
+    nearestTo() {
+        this._textStr = 'nearest to';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Press one Android keys like `DEL`
+     * Filters for an element containing another element.
      *
-     * @param {ANDROID_KEY} key - A Android key
+     * **Example:**
+     * ```typescript
+     * --------------------
+     * |     outerEl      |
+     * |  --------------  |
+     * |  |  innerEl   |  |
+     * |  --------------  |
+     * |                  |
+     * --------------------
      *
-     * @return {Exec}
-     */
-    pressAndroidKey(key) {
-        this._textStr = `Press android key ${key}`;
-        return new Exec(this);
-    }
-}
-exports.FluentCommand = FluentCommand;
-class ExecGetter extends FluentBase {
-    exec() {
-        return this.getterStringBuilder();
-    }
-}
-exports.ExecGetter = ExecGetter;
-// Filters
-class FluentFiltersGetter extends FluentBase {
-    /**
-     * Filters for a UI element 'wizard item active'.
+     * // 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 {FluentFiltersOrRelationsGetter}
+     * @return {FluentFiltersCondition}
      */
-    wizardItemActive() {
-        this._textStr = 'wizard item active';
-        return new FluentFiltersOrRelationsGetter(this);
+    contains() {
+        this._textStr = 'contains';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Filters for a UI element 'wizard item'.
+     * Expects that filtered element exists.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    wizardItem() {
-        this._textStr = 'wizard item';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'wizard'.
+     * Always use together with `expect()`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    wizard() {
-        this._textStr = 'wizard';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'windows bar'.
+     * **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.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    windowsBar() {
-        this._textStr = 'windows bar';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'window'.
+     * **Examples:**
+     * ```typescript
+     * // Stops execution at this point when the element does not exist.
+     * await aui.expect().text().withText('Login').exists().exec()
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    window() {
-        this._textStr = 'window';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'video'.
+     * // 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 {FluentFiltersOrRelationsGetter}
+     * @return {ExecCondition}
      */
-    video() {
-        this._textStr = 'video';
-        return new FluentFiltersOrRelationsGetter(this);
+    exists() {
+        this._textStr = 'exists';
+        return new ExecCondition(this);
     }
     /**
-     * Filters for a UI element 'url'.
+     * Expects that filtered element not exists.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    url() {
-        this._textStr = 'url';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'tooltip'.
+     * Always use together with `expect()`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tooltip() {
-        this._textStr = 'tooltip';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'textfield'.
+     * **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.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    textfield() {
-        this._textStr = 'textfield';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'textarea'.
+     * **Examples:**
+     * ```typescript
+     * // Stops execution at this point when the element does exist.
+     * await aui.expect().text().withText('Login').notExists().exec()
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    textarea() {
-        this._textStr = 'textarea';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'table row'.
+     * // 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 {FluentFiltersOrRelationsGetter}
+     * @return {ExecCondition}
      */
-    tableRow() {
-        this._textStr = 'table row';
-        return new FluentFiltersOrRelationsGetter(this);
+    notExists() {
+        this._textStr = 'not exists';
+        return new ExecCondition(this);
     }
-    /**
-     * Filters for a UI element 'table header'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tableHeader() {
-        this._textStr = 'table header';
-        return new FluentFiltersOrRelationsGetter(this);
+}
+exports.FluentFiltersOrRelationsCondition = FluentFiltersOrRelationsCondition;
+class ExecCondition extends Exec {
+}
+// Commands
+class FluentCommand extends FluentBase {
+    constructor() {
+        super(undefined);
     }
     /**
-     * Filters for a UI element 'table column'.
+     * Expects a condition, e.g., `exists()` or `notExits()`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tableColumn() {
-        this._textStr = 'table column';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'table'.
+     * Use the structure `expect().<your filter>.(exists()|notExists()` as shown in the examples below.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    table() {
-        this._textStr = 'table';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'tab selected'.
+     * **Examples:**
+     * ```typescript
+     * await aui.expect().text().withText('Login').exists().exec()
+     * await aui.expect().text().withText('Login').notExists().exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {FluentFiltersCondition}
      */
-    tabSelected() {
-        this._textStr = 'tab selected';
-        return new FluentFiltersOrRelationsGetter(this);
+    expect() {
+        this._textStr = 'Expect';
+        return new FluentFiltersCondition(this);
     }
     /**
-     * Filters for a UI element 'tab bar'.
+     * Mouse left-clicks/taps on the filtered element by moving the mouse cursor to the filtered element first.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tabBar() {
-        this._textStr = 'tab bar';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'tab active'.
+     * If you need a simple mouseleftclick/tap only, use `mouseLeftClick`.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    tabActive() {
-        this._textStr = 'tab active';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'tab'.
+     * **Example:**
+     * ```typescript
+     * await aui.click().button().withText('Submit').exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {FluentFilters}
      */
-    tab() {
-        this._textStr = 'tab';
-        return new FluentFiltersOrRelationsGetter(this);
+    click() {
+        this._textStr = 'Click on';
+        return new FluentFilters(this);
     }
     /**
-     * Filters for a UI element 'switch enabled'.
+     * Move mouse over the filtered element.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    switchEnabled() {
-        this._textStr = 'switch enabled';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'switch disabled'.
+     * **Example:**
+     * ```typescript
+     * await aui.moveMouseTo().button().withText('Submit').exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {FluentFilters}
      */
-    switchDisabled() {
-        this._textStr = 'switch disabled';
-        return new FluentFiltersOrRelationsGetter(this);
+    moveMouseTo() {
+        this._textStr = 'Move mouse to';
+        return new FluentFilters(this);
     }
     /**
-     * Filters for a UI element 'status bar'.
+     * Puts the focus on the filtered element and types in the text.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    statusBar() {
-        this._textStr = 'status bar';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'slider indicator'.
+     * **Note:** In the current version it copies the text and pastes it.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    sliderIndicator() {
-        this._textStr = 'slider indicator';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'slider'.
+     * **Examples:**
+     * ```typescript
+     * await aui.typeIn('Type some text').textfield().exec()
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    slider() {
-        this._textStr = 'slider';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'sidebar'.
+     * // mask the text so it is not send to the askui-inference server
+     * await aui.typeIn('Type some text', { isSecret: true, secretMask: '**' }).textfield().exec()
+     * ```
+     * ![](https://docs.askui.com/img/gif/typeIn.gif)
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    sidebar() {
-        this._textStr = 'sidebar';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'scroll bar'.
+     * @param {string} text - A text to type
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {FluentFilters}
      */
-    scrollBar() {
-        this._textStr = 'scroll bar';
-        return new FluentFiltersOrRelationsGetter(this);
+    typeIn(text) {
+        this._textStr = `Type ${Separators.STRING}${text}${Separators.STRING} in`;
+        return new FluentFilters(this);
     }
     /**
-     * Filters for a UI element 'rect'.
+     * Moves mouse to the filtered element and scrolls in the x and y direction.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    rect() {
-        this._textStr = 'rect';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'recaptcha'.
+     * **macOS**: May not work as expected!
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    recaptcha() {
-        this._textStr = 'recaptcha';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'rate'.
+     * **Example:**
+     * ```typescript
+     * await aui.scroll(0, 10).textarea().exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    rate() {
-        this._textStr = 'rate';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'radio button unselected'.
+     * @param {number} x_offset - A (positive/negative) x direction.
+     * @param {number} y_offset - A (positive/negative) y direction.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {FluentFilters}
      */
-    radioButtonUnselected() {
-        this._textStr = 'radio button unselected';
-        return new FluentFiltersOrRelationsGetter(this);
+    scrollInside(x_offset, y_offset) {
+        this._textStr = `Scroll x ${x_offset} y ${y_offset} in`;
+        return new FluentFilters(this);
     }
     /**
-     * Filters for a UI element 'radio button selected'.
+     * Moves the mouse relatively to an element in the direction.
+     * This can be used when the mouse should not hover over an element anymore.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    radioButtonSelected() {
-        this._textStr = 'radio button selected';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'progressbar'.
+     * **Examples:**
+     * ```typescript
+     * // Move mouse 30 pixels below button
+     * await aui.moveMouseRelativelyTo(0, 30).button().withText('Submit').exec()
+     * ```
+     * ![](https://docs.askui.com/img/gif/moveMouseRelativelyTo.gif)
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    progressbar() {
-        this._textStr = 'progressbar';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'progress bar'.
+     * @param {number} x_offset - A (positive/negative) x direction.
+     * @param {number} y_offset - A (positive/negative) y direction.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {FluentFilters}
      */
-    progressBar() {
-        this._textStr = 'progress bar';
-        return new FluentFiltersOrRelationsGetter(this);
+    moveMouseRelativelyTo(x_offset, y_offset) {
+        this._textStr = `Move mouse x ${x_offset} y ${y_offset} relatively to`;
+        return new FluentFilters(this);
     }
     /**
-     * Filters for a UI element 'popover'.
+     * Swipe an element in the x and y direction.
+     * Holds the left mouse button down on Windows, Linux and macOS and drags the element.
+     * On touch devices it taps the element and then drags it.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    popover() {
-        this._textStr = 'popover';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'pil'.
+     * **Example:**
+     * ```typescript
+     * // Swipe the element 500 to the right
+     * await aui.swipe(500, 0).image().exec()
+     * ```
+     * ![](https://docs.askui.com/img/gif/swipe.gif)
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    pil() {
-        this._textStr = 'pil';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'password'.
+     * @param {number} x_offset - A x direction. positive and negative values are accepted
+     * @param {number} y_offset - A y direction. positive and negative values are accepted
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {FluentFilters}
      */
-    password() {
-        this._textStr = 'password';
-        return new FluentFiltersOrRelationsGetter(this);
+    swipe(x_offset, y_offset) {
+        this._textStr = `Swipe x ${x_offset} y ${y_offset}`;
+        return new FluentFilters(this);
     }
     /**
-     * Filters for a UI element 'pager'.
+     * Types a text at the current position.
+     * If you need to focus the element first, use typeIn()
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    pager() {
-        this._textStr = 'pager';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'navigation bar'.
+     * **Note:** In the current version it copies the text and pastes it.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    navigationBar() {
-        this._textStr = 'navigation bar';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'mouse text'.
+     * **Examples:**
+     * ```typescript
+     * await aui.type('Type some text').exec()
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    mouseText() {
-        this._textStr = 'mouse text';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'mouse pointer'.
+     * // mask the text so it is not send to the askui-inference server
+     * await aui.type('Type some text', { isSecret: true, secretMask: '**' }).exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    mousePointer() {
-        this._textStr = 'mouse pointer';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'mouse cursor'.
+     * @param {string} text - A text to type
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    mouseCursor() {
-        this._textStr = 'mouse cursor';
-        return new FluentFiltersOrRelationsGetter(this);
+    type(text) {
+        this._textStr = `Type ${Separators.STRING}${text}${Separators.STRING}`;
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'modal'.
+     * Moves the mouse from the current position (relative) in x and y direction.
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    modal() {
-        this._textStr = 'modal';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'message box'.
+     * **Example:**
+     * ```typescript
+     * await aui.moveMouseRelatively(20, 20).exec();
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @param {number} x_offset - A (positive/negative) x direction.
+     * @param {number} y_offset - A (positive/negative) y direction.
+     *
+     * @return {Exec}
      */
-    messageBox() {
-        this._textStr = 'message box';
-        return new FluentFiltersOrRelationsGetter(this);
+    moveMouseRelatively(x_offset, y_offset) {
+        this._textStr = `Move mouse from current position with x ${x_offset} y ${y_offset}`;
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'map'.
+     * Moves the mouse to the absolute x and y coordinates.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * 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.
+     *
+     * @return {Exec}
      */
-    map() {
-        this._textStr = 'map';
-        return new FluentFiltersOrRelationsGetter(this);
+    moveMouse(x_coordinate, y_coordinate) {
+        this._textStr = `Move mouse to x ${x_coordinate} y ${y_coordinate}`;
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'logo'.
+     * Scrolls based on the current mouse position in the x and y direction.
+     *
+     * **Important**: Mouse must be positioned in a scrollable area.
+     *
+     * **macOS**: May not work as expected!
+     *
+     * **Example:**
+     * ```typescript
+     * // Scroll 10 up in y direction
+     * await aui.scroll(0, 10).exec()
+     * ```
      *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    logo() {
-        this._textStr = 'logo';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * Filters for a UI element 'link'.
+     * @param {number} x_offset - A (positive/negative) x direction.
+     * @param {number} y_offset - A (positive/negative) y direction.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @return {Exec}
      */
-    link() {
-        this._textStr = 'link';
-        return new FluentFiltersOrRelationsGetter(this);
+    scroll(x_offset, y_offset) {
+        this._textStr = `Scroll x ${x_offset} y ${y_offset}`;
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'keyboard'.
+     * Executes a shell command on the device your UiController is connected to.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * **Example:**
+     * ```typescript
+     * // Open the lastpass app
+     * await aui.execOnShell('monkey -p com.lastpass.authenticator 1').exec();
+     *
+     * // Open Google Chrome on Windows
+     * await aui.execOnShell("start chrome").exec()
+     *
+     * ;// Open Google Chrome on macOS
+     * await aui.execOnShell("open -a 'Google Chrome'").exec();
+     *
+     * // Open Google Chrome on Linux
+     * await aui.execOnShell("chrome").exec();
+     * ```
+     *
+     * @param {string} shell_command - A shell command which is executed.
+     *
+     * @return {Exec}
      */
-    keyboard() {
-        this._textStr = 'keyboard';
-        return new FluentFiltersOrRelationsGetter(this);
+    execOnShell(shell_command) {
+        this._textStr = `Execute shell command ${Separators.STRING}${shell_command}${Separators.STRING}`;
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'image'.
+     * Clicks with left mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * If you need to move the mouse first, use `moveMouseTo()`.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
+     *
+     * await aui.mouseLeftClick().exec();
+     * ```
+     *
+     * @return {Exec}
      */
-    image() {
-        this._textStr = 'image';
-        return new FluentFiltersOrRelationsGetter(this);
+    mouseLeftClick() {
+        this._textStr = 'Mouse left click';
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'header'.
+     * Clicks with right mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * If you need to move the mouse first, use `moveMouseTo()`.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
+     *
+     * await aui.mouseRightClick().exec();
+     * ```
+     *
+     * @return {Exec}
      */
-    header() {
-        this._textStr = 'header';
-        return new FluentFiltersOrRelationsGetter(this);
+    mouseRightClick() {
+        this._textStr = 'Mouse right click';
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'footer'.
+     * Clicks with middle mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * If you need to move the mouse first, use `moveMouseTo()`.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
+     *
+     * await aui.mouseMiddleClick().exec();
+     * ```
+     *
+     * @return {Exec}
      */
-    footer() {
-        this._textStr = 'footer';
-        return new FluentFiltersOrRelationsGetter(this);
+    mouseMiddleClick() {
+        this._textStr = 'Mouse middle click';
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'flag'.
+     * Double-clicks with left mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * If you need to move the mouse first, use `moveMouseTo()`.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
+     *
+     * await aui.mouseDoubleLeftClick().exec();
+     * ```
+     *
+     * @return {Exec}
      */
-    flag() {
-        this._textStr = 'flag';
-        return new FluentFiltersOrRelationsGetter(this);
+    mouseDoubleLeftClick() {
+        this._textStr = 'Mouse double left click';
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'dropdown menu'.
+     * Double-clicks with right mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * If you need to move the mouse first, use `moveMouseTo()`.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
+     *
+     * await aui.mouseDoubleRightClick().exec();
+     * ```
+     *
+     * @return {Exec}
      */
-    dropdownMenu() {
-        this._textStr = 'dropdown menu';
-        return new FluentFiltersOrRelationsGetter(this);
+    mouseDoubleRightClick() {
+        this._textStr = 'Mouse double right click';
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'divider'.
+     * Double-clicks with middle mouse key.
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * If you need to move the mouse first, use `moveMouseTo()`.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Optional: Move mouse to an element first
+     * await aui.moveMouseTo().button().withText('Login').exec();
+     *
+     * await aui.mouseDoubleMiddleClick().exec();
+     * ```
+     *
+     * @return {Exec}
      */
-    divider() {
-        this._textStr = 'divider';
-        return new FluentFiltersOrRelationsGetter(this);
+    mouseDoubleMiddleClick() {
+        this._textStr = 'Mouse double middle click';
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'circle'.
+     * Toggles mouse down (Left mouse key/tap).
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * **Example:**
+     * ```typescript
+     * await aui.mouseToggleDown().exec();
+     * ```
+     *
+     * @return {Exec}
      */
-    circle() {
-        this._textStr = 'circle';
-        return new FluentFiltersOrRelationsGetter(this);
+    mouseToggleDown() {
+        this._textStr = 'Mouse toggle down';
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'checkbox unchecked'.
+     * Toggles mouse up (Left mouse key/tap).
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * **Example:**
+     * ```typescript
+     * await aui.mouseToggleUp().exec();
+     * ```
+     *
+     * @return {Exec}
      */
-    checkboxUnchecked() {
-        this._textStr = 'checkbox unchecked';
-        return new FluentFiltersOrRelationsGetter(this);
+    mouseToggleUp() {
+        this._textStr = 'Mouse toggle up';
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'checkbox checked'.
+     * Press three keys like `CTRL+ALT+DEL`
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * **Operating system specific mappings:**
+     * 1. Windows: `command`-key maps to `windows`-key
+     * ---
+     *
+     *
+     * @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}
      */
-    checkboxChecked() {
-        this._textStr = 'checkbox checked';
-        return new FluentFiltersOrRelationsGetter(this);
+    pressThreeKeys(first_key, second_key, third_key) {
+        this._textStr = `Press key ${first_key} ${second_key} ${third_key}`;
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'chart pie'.
+     * Press two keys like `ALT+F4`
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * **Operating system specific mappings:**
+     * 1. Windows: `command`-key maps to `windows`-key
+     * ---
+     *
+     *
+     * @param {MODIFIER_KEY} first_key - A modifier key
+     * @param {PC_KEY} second_key - A key
+     *
+     * @return {Exec}
      */
-    chartPie() {
-        this._textStr = 'chart pie';
-        return new FluentFiltersOrRelationsGetter(this);
+    pressTwoKeys(first_key, second_key) {
+        this._textStr = `Press key ${first_key} ${second_key}`;
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'chart'.
+     * Press one keys like `DEL`
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * **Operating system specific mappings:**
+     * 1. Windows: `command`-key maps to `windows`-key
+     * ---
+     *
+     *
+     * @param {PC_AND_MODIFIER_KEY} key - A key
+     *
+     * @return {Exec}
      */
-    chart() {
-        this._textStr = 'chart';
-        return new FluentFiltersOrRelationsGetter(this);
+    pressKey(key) {
+        this._textStr = `Press key ${key}`;
+        return new Exec(this);
     }
     /**
-     * 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() {
-        this._textStr = 'card';
-        return new FluentFiltersOrRelationsGetter(this);
+    pressAndroidThirdKey(first_key, second_key, third_key) {
+        this._textStr = `Press android key ${first_key} ${second_key} ${third_key}`;
+        return new Exec(this);
     }
     /**
-     * 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() {
-        this._textStr = 'browser bar';
-        return new FluentFiltersOrRelationsGetter(this);
+    pressAndroidTwoKey(first_key, second_key) {
+        this._textStr = `Press android key ${first_key} ${second_key}`;
+        return new Exec(this);
     }
     /**
-     * Filters for a UI element 'breadcrumb'.
+     * Press one Android key like `DEL`
      *
-     * @return {FluentFiltersOrRelationsGetter}
+     * @param {ANDROID_KEY} key - A Android key
+     *
+     * @return {Exec}
      */
-    breadcrumb() {
-        this._textStr = 'breadcrumb';
-        return new FluentFiltersOrRelationsGetter(this);
+    pressAndroidKey(key) {
+        this._textStr = `Press android key ${key}`;
+        return new Exec(this);
+    }
+}
+exports.FluentCommand = FluentCommand;
+class ExecGetter extends FluentBase {
+    exec() {
+        return this.getterStringBuilder();
     }
+}
+exports.ExecGetter = ExecGetter;
+// Filters
+class FluentFiltersGetter extends FluentBase {
     /**
-     * Filters for a UI element 'banner'.
+     * Filters for a UI element 'table'.
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    banner() {
-        this._textStr = 'banner';
+    table() {
+        this._textStr = 'table';
         return new FluentFiltersOrRelationsGetter(this);
     }
     /**
-     * Filters for a UI element 'badge'.
+     * Filters for a UI element 'switch'.
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    badge() {
-        this._textStr = 'badge';
+    switch() {
+        this._textStr = 'switch';
         return new FluentFiltersOrRelationsGetter(this);
     }
     /**
-     * Filters for a UI element 'alert'.
+     * Filters for a UI element 'container'.
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    alert() {
-        this._textStr = 'alert';
+    container() {
+        this._textStr = 'container';
         return new FluentFiltersOrRelationsGetter(this);
     }
     /**
-     * Filters for a UI element 'unknown'.
+     * Filters for a UI element 'checkbox'.
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
-    unknown() {
-        this._textStr = 'unknown';
+    checkbox() {
+        this._textStr = 'checkbox';
         return new FluentFiltersOrRelationsGetter(this);
     }
     /**
-     * Filters for an UI element 'button'.
+     * Filters for a UI element 'button'.
      *
      * **Examples:**
      * ```typescript
@@ -3116,6 +1775,16 @@ class FluentFiltersGetter extends FluentBase {
     /**
      * Filters for an UI element 'text'.
      *
+     * 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}
      */
     text() {
@@ -3123,25 +1792,16 @@ class FluentFiltersGetter extends FluentBase {
         return new FluentFiltersOrRelationsGetter(this);
     }
     /**
-     * Filters for an UI element 'dropdown'.
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    dropdown() {
-        this._textStr = 'dropdown';
-        return new FluentFiltersOrRelationsGetter(this);
-    }
-    /**
-     * 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}
      */
@@ -3150,10 +1810,37 @@ class FluentFiltersGetter extends FluentBase {
         return new FluentFiltersOrRelationsGetter(this);
     }
     /**
-     * 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.
      *
@@ -3165,12 +1852,41 @@ class FluentFiltersGetter extends FluentBase {
         return new FluentFiltersOrRelationsGetter(this);
     }
     /**
-     * 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}
+     */
+    image() {
+        this._textStr = 'image';
+        return new FluentFiltersOrRelationsGetter(this);
+    }
+    /**
+     * 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}
      */
-    checkbox() {
-        this._textStr = 'checkbox';
+    textfield() {
+        this._textStr = 'textfield';
         return new FluentFiltersOrRelationsGetter(this);
     }
     /**
@@ -3250,9 +1966,9 @@ 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)
      *
@@ -3264,6 +1980,17 @@ class FluentFiltersGetter extends FluentBase {
         this._textStr = `contain text ${Separators.STRING}${text}${Separators.STRING}`;
         return new FluentFiltersOrRelationsGetter(this);
     }
+    /**
+     * Filters elements based on a textual description.
+     *
+     * @param {string} text - A description of the target element.
+     *
+     * @return {FluentFiltersOrRelationsGetter}
+     */
+    matching(text) {
+        this._textStr = `matching ${Separators.STRING}${text}${Separators.STRING}`;
+        return new FluentFiltersOrRelationsGetter(this);
+    }
 }
 exports.FluentFiltersGetter = FluentFiltersGetter;
 // Relations
@@ -3285,7 +2012,7 @@ 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);
@@ -3320,12 +2047,13 @@ 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 {
@@ -3350,12 +2078,12 @@ 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 {
@@ -3587,7 +2315,7 @@ class Getter extends FluentCommand {
      *         xmax: 1178.8204241071428,
      *         ymax: 180.83512834821428
      *      }
-     *  }
+     *    }
      *  ]
      * ```
      *
@@ -3630,7 +2358,7 @@ class Getter extends FluentCommand {
      *         ymax: 950.47812834821428
      *      },
      *      ... 381 more items
-     *  }
+     *    }
      *  ]
      * ```
      *