askui 0.17.1 → 0.18.0

package/dist/cjs/execution/index.d.ts

@@ -1 +1 @@
-export { UiControlClient } from './ui-control-client';
+export { UiControlClient, RelationsForConvenienceMethods } from './ui-control-client';

package/dist/cjs/execution/ui-control-client.d.ts

@@ -5,6 +5,7 @@ import { Annotation } from '../core/annotation/annotation';
 import { AnnotationRequest } from '../core/model/annotation-result/annotation-interface';
 import { DetectedElement } from '../core/model/annotation-result/detected-element';
 import { ClientArgs } from './ui-controller-client-interface';
+export declare type RelationsForConvenienceMethods = 'nearestTo' | 'leftOf' | 'above' | 'rightOf' | 'below' | 'contains';
 export declare class UiControlClient extends ApiCommands {
     private executionRuntime;
     private stepReporter;
@@ -108,12 +109,6 @@ export declare class UiControlClient extends ApiCommands {
      * @param {PC_AND_MODIFIER_KEY[]} keys
      */
     pressKeys(keys: PC_AND_MODIFIER_KEY[]): Promise<void>;
-    /**
-     * Searches for a text element and clicks it when found.
-     *
-     * @param {string} text - A text to be searched.
-     */
-    clickText(text: string): Promise<void>;
     /**
      * Searches for text elements and clicks them
      * one after another when found.
@@ -121,13 +116,6 @@ export declare class UiControlClient extends ApiCommands {
      * @param {string[]} texts - An array of texts to be searched.
      */
     clickTexts(texts: string[]): Promise<void>;
-    /**
-     * Searches for an element of type button
-     * with a label and clicks it when found.
-     *
-     * @param {string} label - The buttons label.
-     */
-    clickButton(label: string): Promise<void>;
     /**
      * Searches for an element of type textfield with a specific placeholder text.
      * If found, clicks it.
@@ -162,4 +150,157 @@ export declare class UiControlClient extends ApiCommands {
      * @param {number} waitTime - Time in milliseconds
      */
     waitUntil(AskUICommand: Executable, maxTry?: number, waitTime?: number): Promise<void>;
+    private evaluateRelation;
+    /**
+     * Click a button with a specific label.
+     * Optional relation identifies the button in relation to another element.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.clickButton({})
+     * await aui.clickButton({label: 'Checkout here'})
+     * await aui.clickButton({relation: {type: 'leftOf', text: 'Choose a ticket'}})
+     * await aui.clickButton({label: 'Click', {relation: {type: 'leftOf', text: 'Choose a ticket'}})
+     * ```
+     *
+     * @param {Object} params - Object containing properties.
+     * @property {string} [params.label] - The text label of the button. Defaults to an empty string.
+     * @property {Object} [params.relation] - Object describing the relationship between
+     *                                        the clicked button and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     * @property {string} params.relation.text - The text element the relation is based on.
+     */
+    clickButton(params: {
+        label?: string;
+        relation?: {
+            type: RelationsForConvenienceMethods;
+            text: string;
+        };
+    }): Promise<void>;
+    /**
+     * Click a checkbox with a specific label.
+     * You can also specify where the label is placed relationally.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.clickCheckbox({label: 'Toggle'})
+     * await aui.clickCheckbox({label: 'Toggle', relation: {type: 'leftOf'}})
+     * ```
+     *
+     * @param {Object} params - Object containing required `label` property and
+     *                          optional `relation` property.
+     * @property {string} params.label - The label for the checkbox.
+     * @property {Object} params.relation - Object describing the relationship between
+     *                                      the clicked checkbox and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     */
+    clickCheckbox(params: {
+        label: string;
+        relation?: {
+            type: RelationsForConvenienceMethods;
+        };
+    }): Promise<void>;
+    /**
+     * Click a switch with a specific label.
+     * You can also specify where the label is placed relationally.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.clickSwitch({label: 'Toggle'})
+     * await aui.clickSwitch({label: 'Toggle', relation: {type: 'leftOf'}})
+     * ```
+     *
+     * @param {Object} params - Object containing required `label` property and
+     *                          optional `relation` property.
+     * @property {string} params.label - The label for the checkbox.
+     * @property {Object} params.relation - Object describing the relationship between
+     *                                      the clicked checkbox and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     */
+    clickSwitch(params: {
+        label: string;
+        relation?: {
+            type: RelationsForConvenienceMethods;
+        };
+    }): Promise<void>;
+    /**
+     * Types a given text into a textfield.
+     * Use a relation to specify how to find
+     * the textfield in relation to a specific label.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Finds the textfield nearest to the label 'Email'
+     * await aui.typeIntoTextfield({textToWrite: 'Hello World', relation: {label: 'Email'}});
+     *
+     * // Finds the textfield above/below a label 'Password'
+     * await aui.typeIntoTextfield(
+     *   {textToWrite: 'Hello World', relation: {type: 'above', label: 'Password'}}
+     * );
+     * await aui.typeIntoTextfield(
+     *   {textToWrite: 'Hello World', relation: {type: 'below', label: 'Password'}}
+     * );
+     *
+     * // If there is no label but a placeholder, the label is contained in the textfield
+     * await aui.typeIntoTextfield(
+     *   {textToWrite: 'Hello World', relation: {type: 'contains', label: 'Enter email'}}
+     * );
+     * ```
+     *
+     * @param {Object} params - Object containing required `textToWrite` property and
+     *                          optional `relation` property.
+     * @property {string} params.textToWrite - The text to be typed into the textfield.
+     * @property {Object} params.relation - Object describing the relationship between the
+     *                                      textfield being interacted with and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of
+     *                                                                   relation, optional.
+     * @property {string} params.relation.label - The label associated with the related
+     *                                            element, optional.
+     */
+    typeIntoTextfield(params: {
+        textToWrite: string;
+        relation: {
+            type?: RelationsForConvenienceMethods;
+            label: string;
+        };
+    }): Promise<void>;
+    /**
+     * Click on a specific text.
+     * You can also use a RegEx or match the text exactly by specifyicing the specific flag.
+     * Use a relation to find the text in relation to a specific text.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Click text that matches exactly
+     * await aui.clickText({text: 'askui', type: 'similar'})
+     *
+     * // Click text that contains 'pie' or 'cake' or 'Pie' or 'Cake'
+     * await aui.clickText({text: '.*([Pp]ie|[Cc]ake).*', type: 'regex'})
+     *
+     * // Click the text 'TERMINAL' that is left of the text 'Ports'
+     * await aui.clickText({
+     *     text: 'TERMINAL',
+     *     type: "exact",
+     *     relation: { type: 'leftOf', text: 'PORTS' }
+     *   })
+     * ```
+     * @param {Object} params - Object containing required `text` property and optional properties
+     *                          for regular expression matching and relation.
+     * @property {string} params.text - The text to be clicked.
+     * @property {string} params.type - Whether the text is matched using similarity,
+     *                                  exact match or a regular expression.
+     * @property {Object} params.relation - Object describing the relationship between the
+     *                                      clicked text and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     * @property {string} params.relation.text - The label or text associated with the
+     *                                           related element or state.
+     */
+    clickText(params: {
+        text: string;
+        type: 'similar' | 'exact' | 'regex';
+        relation?: {
+            type: RelationsForConvenienceMethods;
+            text: string;
+        };
+    }): Promise<void>;
 }

package/dist/cjs/execution/ui-control-client.js

@@ -8,8 +8,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UiControlClient = void 0;
+const ValidationError_1 = __importDefault(require("yup/lib/ValidationError"));
 const custom_element_1 = require("../core/model/custom-element");
 const dsl_1 = require("./dsl");
 const annotation_writer_1 = require("../core/annotation/annotation-writer");
@@ -249,16 +253,6 @@ class UiControlClient extends dsl_1.ApiCommands {
             }
         });
     }
-    /**
-     * Searches for a text element and clicks it when found.
-     *
-     * @param {string} text - A text to be searched.
-     */
-    clickText(text) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.click().text(text).exec();
-        });
-    }
     /**
      * Searches for text elements and clicks them
      * one after another when found.
@@ -273,17 +267,6 @@ class UiControlClient extends dsl_1.ApiCommands {
             }
         });
     }
-    /**
-     * Searches for an element of type button
-     * with a label and clicks it when found.
-     *
-     * @param {string} label - The buttons label.
-     */
-    clickButton(label) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.click().button().withText(label).exec();
-        });
-    }
     /**
      * Searches for an element of type textfield with a specific placeholder text.
      * If found, clicks it.
@@ -346,5 +329,220 @@ class UiControlClient extends dsl_1.ApiCommands {
             }
         });
     }
+    // eslint-disable-next-line class-methods-use-this
+    evaluateRelation(command, relation, text) {
+        let commando = command;
+        switch (relation) {
+            case 'nearestTo':
+                commando = command.nearestTo().text(text);
+                break;
+            case 'leftOf':
+                commando = command.leftOf().text(text);
+                break;
+            case 'above':
+                commando = command.above().text(text);
+                break;
+            case 'rightOf':
+                commando = command.rightOf().text(text);
+                break;
+            case 'below':
+                commando = command.below().text(text);
+                break;
+            case 'contains':
+                commando = command.contains().text(text);
+                break;
+            default:
+                throw new ValidationError_1.default('No valid Relation.Type was passed.');
+        }
+        return commando;
+    }
+    /**
+     * Click a button with a specific label.
+     * Optional relation identifies the button in relation to another element.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.clickButton({})
+     * await aui.clickButton({label: 'Checkout here'})
+     * await aui.clickButton({relation: {type: 'leftOf', text: 'Choose a ticket'}})
+     * await aui.clickButton({label: 'Click', {relation: {type: 'leftOf', text: 'Choose a ticket'}})
+     * ```
+     *
+     * @param {Object} params - Object containing properties.
+     * @property {string} [params.label] - The text label of the button. Defaults to an empty string.
+     * @property {Object} [params.relation] - Object describing the relationship between
+     *                                        the clicked button and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     * @property {string} params.relation.text - The text element the relation is based on.
+     */
+    clickButton(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let command = this.click().button();
+            if (params.label) {
+                command = command.withText(params.label);
+            }
+            if (params.relation) {
+                command = this.evaluateRelation(command, params.relation.type, params.relation.text);
+            }
+            yield command.exec();
+        });
+    }
+    /**
+     * Click a checkbox with a specific label.
+     * You can also specify where the label is placed relationally.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.clickCheckbox({label: 'Toggle'})
+     * await aui.clickCheckbox({label: 'Toggle', relation: {type: 'leftOf'}})
+     * ```
+     *
+     * @param {Object} params - Object containing required `label` property and
+     *                          optional `relation` property.
+     * @property {string} params.label - The label for the checkbox.
+     * @property {Object} params.relation - Object describing the relationship between
+     *                                      the clicked checkbox and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     */
+    clickCheckbox(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let command = this.click().checkbox();
+            if (!params.relation) {
+                command = command.nearestTo().text(params.label);
+            }
+            else {
+                command = this.evaluateRelation(command, params.relation.type, params.label);
+            }
+            yield command.exec();
+        });
+    }
+    /**
+     * Click a switch with a specific label.
+     * You can also specify where the label is placed relationally.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.clickSwitch({label: 'Toggle'})
+     * await aui.clickSwitch({label: 'Toggle', relation: {type: 'leftOf'}})
+     * ```
+     *
+     * @param {Object} params - Object containing required `label` property and
+     *                          optional `relation` property.
+     * @property {string} params.label - The label for the checkbox.
+     * @property {Object} params.relation - Object describing the relationship between
+     *                                      the clicked checkbox and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     */
+    clickSwitch(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let command = this.click().switch();
+            if (!params.relation) {
+                command = command.nearestTo().text(params.label);
+            }
+            else {
+                command = this.evaluateRelation(command, params.relation.type, params.label);
+            }
+            yield command.exec();
+        });
+    }
+    /**
+     * Types a given text into a textfield.
+     * Use a relation to specify how to find
+     * the textfield in relation to a specific label.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Finds the textfield nearest to the label 'Email'
+     * await aui.typeIntoTextfield({textToWrite: 'Hello World', relation: {label: 'Email'}});
+     *
+     * // Finds the textfield above/below a label 'Password'
+     * await aui.typeIntoTextfield(
+     *   {textToWrite: 'Hello World', relation: {type: 'above', label: 'Password'}}
+     * );
+     * await aui.typeIntoTextfield(
+     *   {textToWrite: 'Hello World', relation: {type: 'below', label: 'Password'}}
+     * );
+     *
+     * // If there is no label but a placeholder, the label is contained in the textfield
+     * await aui.typeIntoTextfield(
+     *   {textToWrite: 'Hello World', relation: {type: 'contains', label: 'Enter email'}}
+     * );
+     * ```
+     *
+     * @param {Object} params - Object containing required `textToWrite` property and
+     *                          optional `relation` property.
+     * @property {string} params.textToWrite - The text to be typed into the textfield.
+     * @property {Object} params.relation - Object describing the relationship between the
+     *                                      textfield being interacted with and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of
+     *                                                                   relation, optional.
+     * @property {string} params.relation.label - The label associated with the related
+     *                                            element, optional.
+     */
+    typeIntoTextfield(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let command = this.typeIn(params.textToWrite).textfield();
+            if (!params.relation.type) {
+                command = command.nearestTo().text(params.relation.label);
+            }
+            else {
+                command = this.evaluateRelation(command, params.relation.type, params.relation.label);
+            }
+            yield command.exec();
+        });
+    }
+    /**
+     * Click on a specific text.
+     * You can also use a RegEx or match the text exactly by specifyicing the specific flag.
+     * Use a relation to find the text in relation to a specific text.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Click text that matches exactly
+     * await aui.clickText({text: 'askui', type: 'similar'})
+     *
+     * // Click text that contains 'pie' or 'cake' or 'Pie' or 'Cake'
+     * await aui.clickText({text: '.*([Pp]ie|[Cc]ake).*', type: 'regex'})
+     *
+     * // Click the text 'TERMINAL' that is left of the text 'Ports'
+     * await aui.clickText({
+     *     text: 'TERMINAL',
+     *     type: "exact",
+     *     relation: { type: 'leftOf', text: 'PORTS' }
+     *   })
+     * ```
+     * @param {Object} params - Object containing required `text` property and optional properties
+     *                          for regular expression matching and relation.
+     * @property {string} params.text - The text to be clicked.
+     * @property {string} params.type - Whether the text is matched using similarity,
+     *                                  exact match or a regular expression.
+     * @property {Object} params.relation - Object describing the relationship between the
+     *                                      clicked text and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     * @property {string} params.relation.text - The label or text associated with the
+     *                                           related element or state.
+     */
+    clickText(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let command = this.click().text();
+            switch (params.type) {
+                case 'similar':
+                    command = command.withText(params.text);
+                    break;
+                case 'exact':
+                    command = command.withExactText(params.text);
+                    break;
+                case 'regex':
+                    command = command.withTextRegex(params.text);
+                    break;
+                default:
+                    throw new ValidationError_1.default('"type" must be "similar", "exact" or "regex"');
+            }
+            if (params.relation) {
+                command = this.evaluateRelation(command, params.relation.type, params.relation.text);
+            }
+            yield command.exec();
+        });
+    }
 }
 exports.UiControlClient = UiControlClient;

package/dist/cjs/lib/interactive_cli/create-example-project.js

@@ -188,7 +188,7 @@ class CreateExampleProject {
         return __awaiter(this, void 0, void 0, function* () {
             const runCommand = (0, util_1.promisify)(child_process_1.exec);
             const frameworkDependencies = {
-                jest: 'npm i -D @askui/askui-reporters typescript ts-node @types/jest ts-jest jest @askui/jest-allure-circus eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin eslint-plugin-import eslint-plugin-askui hpagent',
+                jest: 'npm i -D @askui/askui-reporters typescript ts-node @types/jest ts-jest jest @askui/jest-allure-circus eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin eslint-plugin-import @askui/eslint-plugin-askui hpagent',
             };
             yield runCommand(frameworkDependencies.jest);
         });

package/dist/cjs/main.d.ts

@@ -1,5 +1,5 @@
 export { UiController } from './lib';
-export { UiControlClient } from './execution';
+export { UiControlClient, RelationsForConvenienceMethods } from './execution';
 export { Instruction, Reporter, ReporterConfig, Snapshot, SnapshotDetailLevel, Step, StepStatus, StepStatusEnd, } from './core/reporting';
 export { Annotation } from './core/annotation/annotation';
 export { DetectedElement } from './core/model/annotation-result/detected-element';

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

@@ -1 +1 @@
-export { UiControlClient } from './ui-control-client';
+export { UiControlClient, RelationsForConvenienceMethods } from './ui-control-client';

package/dist/esm/execution/ui-control-client.d.ts

@@ -5,6 +5,7 @@ import { Annotation } from '../core/annotation/annotation';
 import { AnnotationRequest } from '../core/model/annotation-result/annotation-interface';
 import { DetectedElement } from '../core/model/annotation-result/detected-element';
 import { ClientArgs } from './ui-controller-client-interface';
+export declare type RelationsForConvenienceMethods = 'nearestTo' | 'leftOf' | 'above' | 'rightOf' | 'below' | 'contains';
 export declare class UiControlClient extends ApiCommands {
     private executionRuntime;
     private stepReporter;
@@ -108,12 +109,6 @@ export declare class UiControlClient extends ApiCommands {
      * @param {PC_AND_MODIFIER_KEY[]} keys
      */
     pressKeys(keys: PC_AND_MODIFIER_KEY[]): Promise<void>;
-    /**
-     * Searches for a text element and clicks it when found.
-     *
-     * @param {string} text - A text to be searched.
-     */
-    clickText(text: string): Promise<void>;
     /**
      * Searches for text elements and clicks them
      * one after another when found.
@@ -121,13 +116,6 @@ export declare class UiControlClient extends ApiCommands {
      * @param {string[]} texts - An array of texts to be searched.
      */
     clickTexts(texts: string[]): Promise<void>;
-    /**
-     * Searches for an element of type button
-     * with a label and clicks it when found.
-     *
-     * @param {string} label - The buttons label.
-     */
-    clickButton(label: string): Promise<void>;
     /**
      * Searches for an element of type textfield with a specific placeholder text.
      * If found, clicks it.
@@ -162,4 +150,157 @@ export declare class UiControlClient extends ApiCommands {
      * @param {number} waitTime - Time in milliseconds
      */
     waitUntil(AskUICommand: Executable, maxTry?: number, waitTime?: number): Promise<void>;
+    private evaluateRelation;
+    /**
+     * Click a button with a specific label.
+     * Optional relation identifies the button in relation to another element.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.clickButton({})
+     * await aui.clickButton({label: 'Checkout here'})
+     * await aui.clickButton({relation: {type: 'leftOf', text: 'Choose a ticket'}})
+     * await aui.clickButton({label: 'Click', {relation: {type: 'leftOf', text: 'Choose a ticket'}})
+     * ```
+     *
+     * @param {Object} params - Object containing properties.
+     * @property {string} [params.label] - The text label of the button. Defaults to an empty string.
+     * @property {Object} [params.relation] - Object describing the relationship between
+     *                                        the clicked button and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     * @property {string} params.relation.text - The text element the relation is based on.
+     */
+    clickButton(params: {
+        label?: string;
+        relation?: {
+            type: RelationsForConvenienceMethods;
+            text: string;
+        };
+    }): Promise<void>;
+    /**
+     * Click a checkbox with a specific label.
+     * You can also specify where the label is placed relationally.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.clickCheckbox({label: 'Toggle'})
+     * await aui.clickCheckbox({label: 'Toggle', relation: {type: 'leftOf'}})
+     * ```
+     *
+     * @param {Object} params - Object containing required `label` property and
+     *                          optional `relation` property.
+     * @property {string} params.label - The label for the checkbox.
+     * @property {Object} params.relation - Object describing the relationship between
+     *                                      the clicked checkbox and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     */
+    clickCheckbox(params: {
+        label: string;
+        relation?: {
+            type: RelationsForConvenienceMethods;
+        };
+    }): Promise<void>;
+    /**
+     * Click a switch with a specific label.
+     * You can also specify where the label is placed relationally.
+     *
+     * **Examples:**
+     * ```typescript
+     * await aui.clickSwitch({label: 'Toggle'})
+     * await aui.clickSwitch({label: 'Toggle', relation: {type: 'leftOf'}})
+     * ```
+     *
+     * @param {Object} params - Object containing required `label` property and
+     *                          optional `relation` property.
+     * @property {string} params.label - The label for the checkbox.
+     * @property {Object} params.relation - Object describing the relationship between
+     *                                      the clicked checkbox and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     */
+    clickSwitch(params: {
+        label: string;
+        relation?: {
+            type: RelationsForConvenienceMethods;
+        };
+    }): Promise<void>;
+    /**
+     * Types a given text into a textfield.
+     * Use a relation to specify how to find
+     * the textfield in relation to a specific label.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Finds the textfield nearest to the label 'Email'
+     * await aui.typeIntoTextfield({textToWrite: 'Hello World', relation: {label: 'Email'}});
+     *
+     * // Finds the textfield above/below a label 'Password'
+     * await aui.typeIntoTextfield(
+     *   {textToWrite: 'Hello World', relation: {type: 'above', label: 'Password'}}
+     * );
+     * await aui.typeIntoTextfield(
+     *   {textToWrite: 'Hello World', relation: {type: 'below', label: 'Password'}}
+     * );
+     *
+     * // If there is no label but a placeholder, the label is contained in the textfield
+     * await aui.typeIntoTextfield(
+     *   {textToWrite: 'Hello World', relation: {type: 'contains', label: 'Enter email'}}
+     * );
+     * ```
+     *
+     * @param {Object} params - Object containing required `textToWrite` property and
+     *                          optional `relation` property.
+     * @property {string} params.textToWrite - The text to be typed into the textfield.
+     * @property {Object} params.relation - Object describing the relationship between the
+     *                                      textfield being interacted with and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of
+     *                                                                   relation, optional.
+     * @property {string} params.relation.label - The label associated with the related
+     *                                            element, optional.
+     */
+    typeIntoTextfield(params: {
+        textToWrite: string;
+        relation: {
+            type?: RelationsForConvenienceMethods;
+            label: string;
+        };
+    }): Promise<void>;
+    /**
+     * Click on a specific text.
+     * You can also use a RegEx or match the text exactly by specifyicing the specific flag.
+     * Use a relation to find the text in relation to a specific text.
+     *
+     * **Examples:**
+     * ```typescript
+     * // Click text that matches exactly
+     * await aui.clickText({text: 'askui', type: 'similar'})
+     *
+     * // Click text that contains 'pie' or 'cake' or 'Pie' or 'Cake'
+     * await aui.clickText({text: '.*([Pp]ie|[Cc]ake).*', type: 'regex'})
+     *
+     * // Click the text 'TERMINAL' that is left of the text 'Ports'
+     * await aui.clickText({
+     *     text: 'TERMINAL',
+     *     type: "exact",
+     *     relation: { type: 'leftOf', text: 'PORTS' }
+     *   })
+     * ```
+     * @param {Object} params - Object containing required `text` property and optional properties
+     *                          for regular expression matching and relation.
+     * @property {string} params.text - The text to be clicked.
+     * @property {string} params.type - Whether the text is matched using similarity,
+     *                                  exact match or a regular expression.
+     * @property {Object} params.relation - Object describing the relationship between the
+     *                                      clicked text and another element.
+     * @property {RelationsForConvenienceMethods} params.relation.type - The type of relation.
+     * @property {string} params.relation.text - The label or text associated with the
+     *                                           related element or state.
+     */
+    clickText(params: {
+        text: string;
+        type: 'similar' | 'exact' | 'regex';
+        relation?: {
+            type: RelationsForConvenienceMethods;
+            text: string;
+        };
+    }): Promise<void>;
 }