askui 0.6.1 → 0.7.0

package/dist/esm/execution/dsl.js

@@ -637,6 +637,11 @@ export class FluentFilters extends FluentBase {
     /**
      * Filters for an UI element 'button'.
      *
+     * **Examples:**
+     * ```typescript
+     * await aui.moveMouseTo().button().exec()
+     * ```
+     *
      * @return {FluentFiltersOrRelations}
      */
     button() {
@@ -710,8 +715,17 @@ export class FluentFilters extends FluentBase {
      * ```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.
      *
@@ -730,9 +744,11 @@ export class FluentFilters extends FluentBase {
      * '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 - An regex pattern
+     * @param {string} regex_pattern - A regex pattern
      *
      * @return {FluentFiltersOrRelations}
      */
@@ -752,6 +768,8 @@ export class FluentFilters extends FluentBase {
      * '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.
@@ -771,6 +789,7 @@ export class FluentFilters extends FluentBase {
      * '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.
      *
@@ -780,17 +799,6 @@ export class FluentFilters extends FluentBase {
         this._textStr = `contain text ${Separators.STRING}${text}${Separators.STRING}`;
         return new FluentFiltersOrRelations(this);
     }
-    /**
-     * Filters for elements having a specific color.
-     *
-     * @param {COLOR} color - A color to match
-     *
-     * @return {FluentFiltersOrRelations}
-     */
-    colored(color) {
-        this._textStr = `with color ${color}`;
-        return new FluentFiltersOrRelations(this);
-    }
 }
 // Relations
 export class FluentFiltersOrRelations extends FluentFilters {
@@ -822,7 +830,6 @@ export class FluentFiltersOrRelations extends FluentFilters {
      *   DetectedElement {
      *      name: 'BUTTON',
      *      text: 'button',
-     *      colors: [ 'red', 'black', 'red' ],
      *      bndbox: BoundingBox {
      *         xmin: 900,
      *         ymin: 910,
@@ -845,21 +852,19 @@ export class FluentFiltersOrRelations extends FluentFilters {
      * **Examples:**
      * ```text
      * example scene:
-     *  --------------------------   --------------------------
-     *  |  icon user colored black | |  icon  user colored red |
-     *  --------------------------   --------------------------
-     * ```
+     *  ---------------   ----------------
+     *  |  icon user  |   |  icon search |
+     *  ---------------   ---------------n```
      * ```typescript
-     * const icons = await aui.get().icon().withText('user').exec();
+     * const icons = await aui.get().icon().exec();
      * console.log(icons);
      * ```
-     * Using only the filter withText, the get command will return both icons because they share the same text
+     * Using only the filter icon, the get command will return both icons
      * ```text
      * console output: [
      *   DetectedElement {
      *      name: 'ICON',
      *      text: 'user',
-     *      colors: [ 'black', 'black', 'black' ],
      *      bndbox: BoundingBox {
      *         xmin: 1000,
      *         ymin: 1010,
@@ -869,8 +874,7 @@ export class FluentFiltersOrRelations extends FluentFilters {
      *   },
      *   DetectedElement {
      *      name: 'ICON',
-     *      text: 'user',
-     *      colors: [ 'red', 'red', 'red' ],
+     *      text: 'search',
      *      bndbox: BoundingBox {
      *         xmin: 900,
      *         ymin: 910,
@@ -882,16 +886,15 @@ export class FluentFiltersOrRelations extends FluentFilters {
      * ```
      * You can combine filters with **the `and()` relation** and specify exactly which icon you want
      * ```typescript
-     * const icons = await aui.get().icon().withText('user').and().colored('red').exec()
+     * const icons = await aui.get().icon().and().withText('user').exec()
      * console.log(icons)
      * ```
-     * The get command returns only the red icon although both icons have the same text
+     * The get command returns only the user icon although both elements are icons
      * ```text
      *  console output: [
      *   DetectedElement {
      *      name: 'ICON',
      *      text: 'user',
-     *      colors: [ 'red', 'red', 'red' ],
      *      bndbox: BoundingBox {
      *         xmin: 900,
      *         ymin: 910,
@@ -926,6 +929,7 @@ export class FluentFiltersOrRelations extends FluentFilters {
      * // Returns nothing because innerEl is not inside outerEl
      * ...outerEl().in().innerEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/in.gif)
      *
      * @return {FluentFilters}
      */
@@ -947,6 +951,7 @@ export class FluentFiltersOrRelations extends FluentFilters {
      * // Returns no element because leftEl is left of rightEl
      * ...leftEl().rightOf().rightEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/rightOf.gif)
      *
      * @return {FluentFilters}
      */
@@ -968,6 +973,7 @@ export class FluentFiltersOrRelations extends FluentFilters {
      * // Returns no element because rightEl is left of leftEl
      * ...rightEl().leftOf().leftEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/leftOf.gif)
      *
      * @return {FluentFilters}
      */
@@ -992,6 +998,7 @@ export class FluentFiltersOrRelations extends FluentFilters {
      * // Returns no element because text is above button
      * ...text().below().button()
      * ```
+     * ![](https://docs.askui.com/img/gif/below.gif)
      *
      * @return {FluentFilters}
      */
@@ -1016,6 +1023,7 @@ export class FluentFiltersOrRelations extends FluentFilters {
      * // Returns no element because button is below text
      * ...button().above().text()
      * ```
+     * ![](https://docs.askui.com/img/gif/above.gif)
      *
      * @return {FluentFilters}
      */
@@ -1044,6 +1052,7 @@ export class FluentFiltersOrRelations extends FluentFilters {
      * // 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}
      */
@@ -1069,6 +1078,7 @@ export class FluentFiltersOrRelations extends FluentFilters {
      * //  Returns no element because innerEl contains no outerEl
      * ...innerEl().contains().outerEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/contains.gif)
      *
      * @return {FluentFilters}
      */
@@ -1661,6 +1671,11 @@ export class FluentFiltersCondition extends FluentBase {
     /**
      * Filters for an UI element 'button'.
      *
+     * **Examples:**
+     * ```typescript
+     * await aui.moveMouseTo().button().exec()
+     * ```
+     *
      * @return {FluentFiltersOrRelationsCondition}
      */
     button() {
@@ -1734,8 +1749,17 @@ export class FluentFiltersCondition extends FluentBase {
      * ```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.
      *
@@ -1754,9 +1778,11 @@ export class FluentFiltersCondition extends FluentBase {
      * '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 - An regex pattern
+     * @param {string} regex_pattern - A regex pattern
      *
      * @return {FluentFiltersOrRelationsCondition}
      */
@@ -1776,6 +1802,8 @@ export class FluentFiltersCondition extends FluentBase {
      * '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.
@@ -1795,6 +1823,7 @@ export class FluentFiltersCondition extends FluentBase {
      * '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.
      *
@@ -1804,17 +1833,6 @@ export class FluentFiltersCondition extends FluentBase {
         this._textStr = `contain text ${Separators.STRING}${text}${Separators.STRING}`;
         return new FluentFiltersOrRelationsCondition(this);
     }
-    /**
-     * Filters for elements having a specific color.
-     *
-     * @param {COLOR} color - A color to match
-     *
-     * @return {FluentFiltersOrRelationsCondition}
-     */
-    colored(color) {
-        this._textStr = `with color ${color}`;
-        return new FluentFiltersOrRelationsCondition(this);
-    }
 }
 // Relations
 export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
@@ -1846,7 +1864,6 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      *   DetectedElement {
      *      name: 'BUTTON',
      *      text: 'button',
-     *      colors: [ 'red', 'black', 'red' ],
      *      bndbox: BoundingBox {
      *         xmin: 900,
      *         ymin: 910,
@@ -1869,21 +1886,19 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * **Examples:**
      * ```text
      * example scene:
-     *  --------------------------   --------------------------
-     *  |  icon user colored black | |  icon  user colored red |
-     *  --------------------------   --------------------------
-     * ```
+     *  ---------------   ----------------
+     *  |  icon user  |   |  icon search |
+     *  ---------------   ---------------n```
      * ```typescript
-     * const icons = await aui.get().icon().withText('user').exec();
+     * const icons = await aui.get().icon().exec();
      * console.log(icons);
      * ```
-     * Using only the filter withText, the get command will return both icons because they share the same text
+     * Using only the filter icon, the get command will return both icons
      * ```text
      * console output: [
      *   DetectedElement {
      *      name: 'ICON',
      *      text: 'user',
-     *      colors: [ 'black', 'black', 'black' ],
      *      bndbox: BoundingBox {
      *         xmin: 1000,
      *         ymin: 1010,
@@ -1893,8 +1908,7 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      *   },
      *   DetectedElement {
      *      name: 'ICON',
-     *      text: 'user',
-     *      colors: [ 'red', 'red', 'red' ],
+     *      text: 'search',
      *      bndbox: BoundingBox {
      *         xmin: 900,
      *         ymin: 910,
@@ -1906,16 +1920,15 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * ```
      * You can combine filters with **the `and()` relation** and specify exactly which icon you want
      * ```typescript
-     * const icons = await aui.get().icon().withText('user').and().colored('red').exec()
+     * const icons = await aui.get().icon().and().withText('user').exec()
      * console.log(icons)
      * ```
-     * The get command returns only the red icon although both icons have the same text
+     * The get command returns only the user icon although both elements are icons
      * ```text
      *  console output: [
      *   DetectedElement {
      *      name: 'ICON',
      *      text: 'user',
-     *      colors: [ 'red', 'red', 'red' ],
      *      bndbox: BoundingBox {
      *         xmin: 900,
      *         ymin: 910,
@@ -1950,6 +1963,7 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * // Returns nothing because innerEl is not inside outerEl
      * ...outerEl().in().innerEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/in.gif)
      *
      * @return {FluentFiltersCondition}
      */
@@ -1971,6 +1985,7 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * // Returns no element because leftEl is left of rightEl
      * ...leftEl().rightOf().rightEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/rightOf.gif)
      *
      * @return {FluentFiltersCondition}
      */
@@ -1992,6 +2007,7 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * // Returns no element because rightEl is left of leftEl
      * ...rightEl().leftOf().leftEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/leftOf.gif)
      *
      * @return {FluentFiltersCondition}
      */
@@ -2016,6 +2032,7 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * // Returns no element because text is above button
      * ...text().below().button()
      * ```
+     * ![](https://docs.askui.com/img/gif/below.gif)
      *
      * @return {FluentFiltersCondition}
      */
@@ -2040,6 +2057,7 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * // Returns no element because button is below text
      * ...button().above().text()
      * ```
+     * ![](https://docs.askui.com/img/gif/above.gif)
      *
      * @return {FluentFiltersCondition}
      */
@@ -2068,6 +2086,7 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * // 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 {FluentFiltersCondition}
      */
@@ -2093,6 +2112,7 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
      * //  Returns no element because innerEl contains no outerEl
      * ...innerEl().contains().outerEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/contains.gif)
      *
      * @return {FluentFiltersCondition}
      */
@@ -2103,6 +2123,11 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
     /**
      * Expects that filtered element exists.
      *
+     * **Examples:**
+     * ```typescript
+     * await aui.expect().text().withText('Login').exists().exec()
+     * ```
+     *
      * @return {ExecCondition}
      */
     exists() {
@@ -2112,6 +2137,11 @@ export class FluentFiltersOrRelationsCondition extends FluentFiltersCondition {
     /**
      * Expects that filtered element does not exist.
      *
+     * **Examples:**
+     * ```typescript
+     * await aui.expect().text().withText('Login').notExists().exec()
+     * ```
+     *
      * @return {ExecCondition}
      */
     notExists() {
@@ -2127,8 +2157,13 @@ export class FluentCommand extends FluentBase {
         super(undefined);
     }
     /**
-     * Expects a condition, e.g., `exists()` or `notExits()`,
-     *  e.g., `...expect().text().withText('Login').exists()`.
+     * Expects a condition, e.g., `exists()` or `notExits()`.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.expect().text().withText('Login').exists().exec()
+     * await aui.expect().text().withText('Login').notExists().exec()
+     * ```
      *
      * @return {FluentFiltersCondition}
      */
@@ -2139,6 +2174,11 @@ export class FluentCommand extends FluentBase {
     /**
      * Clicks on the filtered element.
      *
+     * **Example:**
+     * ```typescript
+     * await aui.click().button().withText('Submit').exec()
+     * ```
+     *
      * @return {FluentFilters}
      */
     click() {
@@ -2148,6 +2188,11 @@ export class FluentCommand extends FluentBase {
     /**
      * Move mouse over the filtered element.
      *
+     * **Example:**
+     * ```typescript
+     * await aui.moveMouseTo().button().withText('Submit').exec()
+     * ```
+     *
      * @return {FluentFilters}
      */
     moveMouseTo() {
@@ -2155,7 +2200,16 @@ export class FluentCommand extends FluentBase {
         return new FluentFilters(this);
     }
     /**
-     * Types a text inside the filtered element.
+     * Puts the focus on the filtered element and types in the text.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.typeIn('Type some text').textfield().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()
+     * ```
+     * ![](https://docs.askui.com/img/gif/typeIn.gif)
      *
      * @param {string} text - A text to type
      *
@@ -2168,6 +2222,13 @@ export class FluentCommand extends FluentBase {
     /**
      * Moves mouse to the filtered element and scrolls in the x and y direction.
      *
+     * **macOS**: May not work as expected!
+     *
+     * **Example:**
+     * ```typescript
+     * await aui.scroll(0, 10).textarea().exec()
+     * ```
+     *
      * @param {number} x_offset - A (positive/negative) x direction.
      * @param {number} y_offset - A (positive/negative) y direction.
      *
@@ -2179,7 +2240,14 @@ export class FluentCommand extends FluentBase {
     }
     /**
      * Moves the mouse relatively to an element in the direction.
-     * This can be used when the mouse should not hover over on an element anymore.
+     * This can be used when the mouse should not hover over an element anymore.
+     *
+     * **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)
      *
      * @param {number} x_offset - A (positive/negative) x direction.
      * @param {number} y_offset - A (positive/negative) y direction.
@@ -2191,10 +2259,19 @@ export class FluentCommand extends FluentBase {
         return new FluentFilters(this);
     }
     /**
-     * Swipe an element in the x and y direction
+     * 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.
      *
-     * @param {number} x_offset - A x direction. positive an negative values are accepted
-     * @param {number} y_offset - A y direction. positive an negative values are accepted
+     * **Example:**
+     * ```typescript
+     * // Swipe the element 500 to the right
+     * await aui.swipe(500, 0).image().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
      *
      * @return {FluentFilters}
      */
@@ -2204,6 +2281,14 @@ export class FluentCommand extends FluentBase {
     }
     /**
      * Types a text at the current position.
+     * If you need to focus the element first, use typeIn()
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.type('Type some text').exec()
+     *
+     * // mask the text so it is not send to the askui-inference serverawait aui.type('Type some text', { isSecret: true, secretMask: '**' }).exec()
+     * ```
      *
      * @param {string} text - A text to type
      *
@@ -2242,6 +2327,14 @@ export class FluentCommand extends FluentBase {
      *
      * **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()
+     * ```
+     *
      * @param {number} x_offset - A (positive/negative) x direction.
      * @param {number} y_offset - A (positive/negative) y direction.
      *
@@ -2252,7 +2345,13 @@ export class FluentCommand extends FluentBase {
         return new Exec(this);
     }
     /**
-     * Executes a shell command.
+     * Executes a shell command on the device.
+     *
+     * **Example:**
+     * ```typescript
+     * // Open the lastpass app
+     * await aui.execOnShell('monkey -p com.lastpass.authenticator 1').exec()
+     * ```
      *
      * @param {string} shell_command - A shell command which is executed.
      *
@@ -2262,78 +2361,6 @@ export class FluentCommand extends FluentBase {
         this._textStr = `Execute shell command ${Separators.STRING}${shell_command}${Separators.STRING}`;
         return new Exec(this);
     }
-    /**
-     * Clicks with left mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseLeftClick() {
-        this._textStr = 'Mouse left click';
-        return new Exec(this);
-    }
-    /**
-     * Clicks with right mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseRightClick() {
-        this._textStr = 'Mouse right click';
-        return new Exec(this);
-    }
-    /**
-     * Clicks with middle mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseMiddleClick() {
-        this._textStr = 'Mouse middle click';
-        return new Exec(this);
-    }
-    /**
-     * Double-clicks with left mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseDoubleLeftClick() {
-        this._textStr = 'Mouse double left click';
-        return new Exec(this);
-    }
-    /**
-     * Double-clicks with right mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseDoubleRightClick() {
-        this._textStr = 'Mouse double right click';
-        return new Exec(this);
-    }
-    /**
-     * Double-clicks with middle mouse key.
-     *
-     * @return {Exec}
-     */
-    mouseDoubleMiddleClick() {
-        this._textStr = 'Mouse double middle click';
-        return new Exec(this);
-    }
-    /**
-     * Toggles mouse down.
-     *
-     * @return {Exec}
-     */
-    mouseToggleDown() {
-        this._textStr = 'Mouse toggle down';
-        return new Exec(this);
-    }
-    /**
-     * Toggles mouse up.
-     *
-     * @return {Exec}
-     */
-    mouseToggleUp() {
-        this._textStr = 'Mouse toggle up';
-        return new Exec(this);
-    }
     /**
      * Press three keys like `CTRL+ALT+DEL`
      *
@@ -2993,6 +3020,11 @@ export class FluentFiltersGetter extends FluentBase {
     /**
      * Filters for an UI element 'button'.
      *
+     * **Examples:**
+     * ```typescript
+     * await aui.moveMouseTo().button().exec()
+     * ```
+     *
      * @return {FluentFiltersOrRelationsGetter}
      */
     button() {
@@ -3066,8 +3098,17 @@ export class FluentFiltersGetter extends FluentBase {
      * ```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.
      *
@@ -3086,9 +3127,11 @@ export class FluentFiltersGetter extends FluentBase {
      * '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 - An regex pattern
+     * @param {string} regex_pattern - A regex pattern
      *
      * @return {FluentFiltersOrRelationsGetter}
      */
@@ -3108,6 +3151,8 @@ export class FluentFiltersGetter extends FluentBase {
      * '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.
@@ -3127,6 +3172,7 @@ export class FluentFiltersGetter extends FluentBase {
      * '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.
      *
@@ -3136,17 +3182,6 @@ export class FluentFiltersGetter extends FluentBase {
         this._textStr = `contain text ${Separators.STRING}${text}${Separators.STRING}`;
         return new FluentFiltersOrRelationsGetter(this);
     }
-    /**
-     * Filters for elements having a specific color.
-     *
-     * @param {COLOR} color - A color to match
-     *
-     * @return {FluentFiltersOrRelationsGetter}
-     */
-    colored(color) {
-        this._textStr = `with color ${color}`;
-        return new FluentFiltersOrRelationsGetter(this);
-    }
 }
 // Relations
 export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
@@ -3178,7 +3213,6 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      *   DetectedElement {
      *      name: 'BUTTON',
      *      text: 'button',
-     *      colors: [ 'red', 'black', 'red' ],
      *      bndbox: BoundingBox {
      *         xmin: 900,
      *         ymin: 910,
@@ -3201,21 +3235,19 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      * **Examples:**
      * ```text
      * example scene:
-     *  --------------------------   --------------------------
-     *  |  icon user colored black | |  icon  user colored red |
-     *  --------------------------   --------------------------
-     * ```
+     *  ---------------   ----------------
+     *  |  icon user  |   |  icon search |
+     *  ---------------   ---------------n```
      * ```typescript
-     * const icons = await aui.get().icon().withText('user').exec();
+     * const icons = await aui.get().icon().exec();
      * console.log(icons);
      * ```
-     * Using only the filter withText, the get command will return both icons because they share the same text
+     * Using only the filter icon, the get command will return both icons
      * ```text
      * console output: [
      *   DetectedElement {
      *      name: 'ICON',
      *      text: 'user',
-     *      colors: [ 'black', 'black', 'black' ],
      *      bndbox: BoundingBox {
      *         xmin: 1000,
      *         ymin: 1010,
@@ -3225,8 +3257,7 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      *   },
      *   DetectedElement {
      *      name: 'ICON',
-     *      text: 'user',
-     *      colors: [ 'red', 'red', 'red' ],
+     *      text: 'search',
      *      bndbox: BoundingBox {
      *         xmin: 900,
      *         ymin: 910,
@@ -3238,16 +3269,15 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      * ```
      * You can combine filters with **the `and()` relation** and specify exactly which icon you want
      * ```typescript
-     * const icons = await aui.get().icon().withText('user').and().colored('red').exec()
+     * const icons = await aui.get().icon().and().withText('user').exec()
      * console.log(icons)
      * ```
-     * The get command returns only the red icon although both icons have the same text
+     * The get command returns only the user icon although both elements are icons
      * ```text
      *  console output: [
      *   DetectedElement {
      *      name: 'ICON',
      *      text: 'user',
-     *      colors: [ 'red', 'red', 'red' ],
      *      bndbox: BoundingBox {
      *         xmin: 900,
      *         ymin: 910,
@@ -3282,6 +3312,7 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      * // Returns nothing because innerEl is not inside outerEl
      * ...outerEl().in().innerEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/in.gif)
      *
      * @return {FluentFiltersGetter}
      */
@@ -3303,6 +3334,7 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      * // Returns no element because leftEl is left of rightEl
      * ...leftEl().rightOf().rightEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/rightOf.gif)
      *
      * @return {FluentFiltersGetter}
      */
@@ -3324,6 +3356,7 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      * // Returns no element because rightEl is left of leftEl
      * ...rightEl().leftOf().leftEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/leftOf.gif)
      *
      * @return {FluentFiltersGetter}
      */
@@ -3348,6 +3381,7 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      * // Returns no element because text is above button
      * ...text().below().button()
      * ```
+     * ![](https://docs.askui.com/img/gif/below.gif)
      *
      * @return {FluentFiltersGetter}
      */
@@ -3372,6 +3406,7 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      * // Returns no element because button is below text
      * ...button().above().text()
      * ```
+     * ![](https://docs.askui.com/img/gif/above.gif)
      *
      * @return {FluentFiltersGetter}
      */
@@ -3400,6 +3435,7 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      * // 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 {FluentFiltersGetter}
      */
@@ -3425,6 +3461,7 @@ export class FluentFiltersOrRelationsGetter extends FluentFiltersGetter {
      * //  Returns no element because innerEl contains no outerEl
      * ...innerEl().contains().outerEl()
      * ```
+     * ![](https://docs.askui.com/img/gif/contains.gif)
      *
      * @return {FluentFiltersGetter}
      */
@@ -3448,8 +3485,8 @@ export class Getter extends FluentCommand {
      * A detected element has the following properties:
      * - `name` of the element
      * - `text` content of element
-     * - `colors` of element
      * - `bndbox`: location of element described with coordinates of a bounding box
+     *
      * **Examples:**
      * ```typescript
      * const text = await aui.get().text().withText('Sign').exec();
@@ -3460,7 +3497,6 @@ export class Getter extends FluentCommand {
      *   DetectedElement {
      *      name: 'TEXT',
      *      text: 'Sign In',
-     *      colors: [ 'black', 'gray', 'gray' ],
      *      bndbox: BoundingBox {
      *         xmin: 1128.2720982142857,
      *         ymin: 160.21332310267857,
@@ -3482,8 +3518,8 @@ export class Getter extends FluentCommand {
      * A detected element has the following properties:
      * - `name` of the element
      * - `text` content of element
-     * - `colors` of element
      * - `bndbox`: location of element described with coordinates of a bounding box
+     *
      * **Examples:**
      * ```typescript
      * const detectedElements = await aui.getAll().exec();
@@ -3494,7 +3530,6 @@ export class Getter extends FluentCommand {
      *   DetectedElement {
      *      name: 'TEXT',
      *      text: 'Sign In',
-     *      colors: [ 'black', 'gray', 'gray' ],
      *      bndbox: BoundingBox {
      *         xmin: 1128.2720982142857,
      *         ymin: 160.21332310267857,
@@ -3504,7 +3539,6 @@ export class Getter extends FluentCommand {
      *   DetectedElement {
      *      name: 'ICON',
      *      text: 'search',
-     *      colors: [ 'black', 'red', 'gray' ],
      *      bndbox: BoundingBox {
      *         xmin: 250.8204241071428,
      *         ymin: 300.21332310267857,