browsertime 26.3.1 → 27.0.0

package/types/core/engine/command/mouse/contextClick.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contextClick.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/contextClick.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IACE,0BASC;IARC;;OAEG;IACH,eAAiC;IACjC;;OAEG;IACH,gBAAmD;IAGrD;;;;;;;OAOG;IACH,eAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,qBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAczB;IAED;;;;;;OAMG;IACH,YAHa,OAAO,CAAC,IAAI,CAAC,CAWzB;CACF"}
+{"version":3,"file":"contextClick.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/contextClick.js"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH;IACE,wCAiBC;IAhBC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,eAAiC;IACjC;;OAEG;IACH,gBAAmD;IACnD;;OAEG;IACH,gBAAsB;IAGxB;;OAEG;IACH,wBAKC;IAED;;;;;;;OAOG;IACH,cAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAkBzB;IAED;;;;;;;;OAQG;IACH,gBAUC;IAED;;;;;;;;OAQG;IACH,mBAYC;IAED;;;;;;;OAOG;IACH,iBASC;CACF"}

package/types/core/engine/command/mouse/doubleClick.d.ts

@@ -5,7 +5,7 @@
  * @hideconstructor
  */
 export class DoubleClick {
-    constructor(browser: any, pageCompleteCheck: any);
+    constructor(browser: any, pageCompleteCheck: any, options: any);
     /**
      * @private
      */
@@ -19,6 +19,24 @@ export class DoubleClick {
      */
     private pageCompleteCheck;
     /**
+     * @private
+     */
+    private options;
+    /**
+     * @private
+     */
+    private _waitForElement;
+    /**
+     * Performs a double click on an element using a unified selector string.
+     *
+     * @async
+     * @param {string} selector - The selector string. CSS by default, or use a prefix.
+     * @returns {Promise<void>}
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    run(selector: string): Promise<void>;
+    /**
+     * @private
      * Performs a mouse double-click on an element matching a given XPath selector.
      *
      * @async
@@ -27,8 +45,9 @@ export class DoubleClick {
      * @returns {Promise<void>} A promise that resolves when the double-click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byXpath(xpath: string, options?: any): Promise<void>;
+    private byXpath;
     /**
+     * @private
      * Performs a mouse double-click on an element matching a given CSS selector.
      *
      * @async
@@ -37,8 +56,9 @@ export class DoubleClick {
      * @returns {Promise<void>} A promise that resolves when the double-click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    bySelector(selector: string, options?: any): Promise<void>;
+    private bySelector;
     /**
+     * @private
      * Performs a mouse double-click at the current cursor position.
      *
      * @async
@@ -46,6 +66,6 @@ export class DoubleClick {
      * @returns {Promise<void>} A promise that resolves when the double-click occurs.
      * @throws {Error} Throws an error if the double-click action cannot be performed.
      */
-    atCursor(options?: any): Promise<void>;
+    private atCursor;
 }
 //# sourceMappingURL=doubleClick.d.ts.map

package/types/core/engine/command/mouse/doubleClick.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doubleClick.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/doubleClick.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IACE,kDAaC;IAZC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,gBAAgE;IAChE;;OAEG;IACH,0BAA0C;IAG5C;;;;;;;;OAQG;IACH,eALW,MAAM,kBAEJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;;;OAQG;IACH,qBALW,MAAM,kBAEJ,OAAO,CAAC,IAAI,CAAC,CAmBzB;IAED;;;;;;;OAOG;IACH,yBAHa,OAAO,CAAC,IAAI,CAAC,CAczB;CACF"}
+{"version":3,"file":"doubleClick.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/doubleClick.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH;IACE,gEAiBC;IAhBC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,gBAAgE;IAChE;;OAEG;IACH,0BAA0C;IAC1C;;OAEG;IACH,gBAAsB;IAGxB;;OAEG;IACH,wBAKC;IAED;;;;;;;OAOG;IACH,cAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAkBzB;IAED;;;;;;;;;OASG;IACH,gBAeC;IAED;;;;;;;;;OASG;IACH,mBAiBC;IAED;;;;;;;;OAQG;IACH,iBAYC;CACF"}

package/types/core/engine/command/mouse/mouseMove.d.ts

@@ -5,7 +5,11 @@
  * @hideconstructor
  */
 export class MouseMove {
-    constructor(browser: any);
+    constructor(browser: any, options: any);
+    /**
+     * @private
+     */
+    private browser;
     /**
      * @private
      */
@@ -15,6 +19,24 @@ export class MouseMove {
      */
     private actions;
     /**
+     * @private
+     */
+    private options;
+    /**
+     * @private
+     */
+    private _waitForElement;
+    /**
+     * Moves the mouse cursor to an element using a unified selector string.
+     *
+     * @async
+     * @param {string} selector - The selector string. CSS by default, or use a prefix.
+     * @returns {Promise<void>}
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    run(selector: string): Promise<void>;
+    /**
+     * @private
      * Moves the mouse cursor to an element that matches a given XPath selector.
      *
      * @async
@@ -22,8 +44,9 @@ export class MouseMove {
      * @returns {Promise<void>} A promise that resolves when the mouse has moved to the element.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byXpath(xpath: string): Promise<void>;
+    private byXpath;
     /**
+     * @private
      * Moves the mouse cursor to an element that matches a given CSS selector.
      *
      * @async
@@ -31,8 +54,9 @@ export class MouseMove {
      * @returns {Promise<void>} A promise that resolves when the mouse has moved to the element.
      * @throws {Error} Throws an error if the element is not found.
      */
-    bySelector(selector: string): Promise<void>;
+    private bySelector;
     /**
+     * @private
      * Moves the mouse cursor to a specific position on the screen.
      *
      * @async
@@ -41,8 +65,9 @@ export class MouseMove {
      * @returns {Promise<void>} A promise that resolves when the mouse has moved to the specified position.
      * @throws {Error} Throws an error if the action cannot be performed.
      */
-    toPosition(xPos: number, yPos: number): Promise<void>;
+    private toPosition;
     /**
+     * @private
      * Moves the mouse cursor by an offset from its current position.
      *
      * @async
@@ -51,6 +76,6 @@ export class MouseMove {
      * @returns {Promise<void>} A promise that resolves when the mouse has moved by the specified offset.
      * @throws {Error} Throws an error if the action cannot be performed.
      */
-    byOffset(xOffset: number, yOffset: number): Promise<void>;
+    private byOffset;
 }
 //# sourceMappingURL=mouseMove.d.ts.map

package/types/core/engine/command/mouse/mouseMove.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mouseMove.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/mouseMove.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IACE,0BASC;IARC;;OAEG;IACH,eAAiC;IACjC;;OAEG;IACH,gBAAmD;IAGrD;;;;;;;OAOG;IACH,eAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,qBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;;OAQG;IACH,iBALW,MAAM,QACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAWzB;IAED;;;;;;;;OAQG;IACH,kBALW,MAAM,WACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAazB;CACF"}
+{"version":3,"file":"mouseMove.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/mouseMove.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH;IACE,wCAiBC;IAhBC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,eAAiC;IACjC;;OAEG;IACH,gBAAmD;IACnD;;OAEG;IACH,gBAAsB;IAGxB;;OAEG;IACH,wBAKC;IAED;;;;;;;OAOG;IACH,cAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;;;OAQG;IACH,gBASC;IAED;;;;;;;;OAQG;IACH,mBASC;IAED;;;;;;;;;OASG;IACH,mBAQC;IAED;;;;;;;;;OASG;IACH,iBAUC;CACF"}

package/types/core/engine/command/mouse/singleClick.d.ts

@@ -5,7 +5,7 @@
  * @class
  */
 export class SingleClick {
-    constructor(browser: any, pageCompleteCheck: any);
+    constructor(browser: any, pageCompleteCheck: any, options: any);
     /**
      * @private
      */
@@ -19,6 +19,32 @@ export class SingleClick {
      */
     private pageCompleteCheck;
     /**
+     * @private
+     */
+    private options;
+    /**
+     * @private
+     */
+    private _waitForElement;
+    /**
+     * Performs a single click on an element using a unified selector string.
+     *
+     * @async
+     * @param {string} selector - The selector string. CSS by default, or use a prefix.
+     * @param {Object} [options] - Options for the click action.
+     * @param {boolean} [options.waitForNavigation=false] - If true, waits for page complete check.
+     * @returns {Promise<void>}
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    run(selector: string, options?: {
+        waitForNavigation?: boolean;
+    }): Promise<void>;
+    /**
+     * @private
+     */
+    private _andWait;
+    /**
+     * @private
      * Performs a single mouse click on an element matching a given XPath selector.
      *
      * @async
@@ -27,8 +53,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the single click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byXpath(xpath: string, options?: any): Promise<void>;
+    private byXpath;
     /**
+     * @private
      * Performs a single mouse click on an element matching a given XPath selector and wait for page complete check.
      *
      * @async
@@ -36,8 +63,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the single click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    byXpathAndWait(xpath: string): Promise<void>;
+    private byXpathAndWait;
     /**
+     * @private
      * Performs a single mouse click on an element matching a given CSS selector.
      *
      * @async
@@ -46,8 +74,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the single click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    bySelector(selector: string, options?: any): Promise<void>;
+    private bySelector;
     /**
+     * @private
      * Performs a single mouse click on an element matching a given CSS selector and waits on the page complete check.
      *
      * @async
@@ -55,8 +84,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the single click action is performed.
      * @throws {Error} Throws an error if the element is not found.
      */
-    bySelectorAndWait(selector: string): Promise<void>;
+    private bySelectorAndWait;
     /**
+     * @private
      * Performs a single mouse click at the current cursor position.
      *
      * @async
@@ -64,8 +94,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the single click occurs.
      * @throws {Error} Throws an error if the single click action cannot be performed.
      */
-    atCursor(options?: any): Promise<void>;
+    private atCursor;
     /**
+     * @private
      * Performs a single mouse click at the current cursor position and waits on the
      * page complete check.
      *
@@ -73,8 +104,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the single click occurs.
      * @throws {Error} Throws an error if the single click action cannot be performed.
      */
-    atCursorAndWait(): Promise<void>;
+    private atCursorAndWait;
     /**
+     * @private
      * Clicks on a link whose visible text matches the given string.
      *
      * @async
@@ -82,8 +114,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the link is not found.
      */
-    byLinkText(text: string): Promise<void>;
+    private byLinkText;
     /**
+     * @private
      * Clicks on a link whose visible text matches the given string and waits on the opage complete check.
      *
      * @async
@@ -91,8 +124,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the link is not found.
      */
-    byLinkTextAndWait(text: string): Promise<void>;
+    private byLinkTextAndWait;
     /**
+     * @private
      * Clicks on a link whose visible text contains the given substring.
      *
      * @async
@@ -100,8 +134,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the link is not found.
      */
-    byPartialLinkText(text: string): Promise<void>;
+    private byPartialLinkText;
     /**
+     * @private
      * Clicks on a link whose visible text contains the given substring and waits on the
      * page complete check.
      *
@@ -110,8 +145,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the link is not found.
      */
-    byPartialLinkTextAndWait(text: string): Promise<void>;
+    private byPartialLinkTextAndWait;
     /**
+     * @private
      * Clicks on a element with a specific id.
      *
      * @async
@@ -119,8 +155,9 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the click action is performed.
      * @throws {Error} Throws an error if the id is not found.
      */
-    byId(id: string): Promise<void>;
+    private byId;
     /**
+     * @private
      * Clicks on a element with a specific id and wait on the page complete check
      *
      * @async
@@ -128,6 +165,6 @@ export class SingleClick {
      * @returns {Promise<void>} A promise that resolves when the page has completed.
      * @throws {Error} Throws an error if the id is not found.
      */
-    byIdAndWait(id: string): Promise<void>;
+    private byIdAndWait;
 }
 //# sourceMappingURL=singleClick.d.ts.map

package/types/core/engine/command/mouse/singleClick.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"singleClick.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/singleClick.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IACE,kDAaC;IAZC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,gBAAgE;IAChE;;OAEG;IACH,0BAA0C;IAG5C;;;;;;;;OAQG;IACH,eALW,MAAM,kBAEJ,OAAO,CAAC,IAAI,CAAC,CAoBzB;IAED;;;;;;;OAOG;IACH,sBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAezB;IAED;;;;;;;;OAQG;IACH,qBALW,MAAM,kBAEJ,OAAO,CAAC,IAAI,CAAC,CAsBzB;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;;OAOG;IACH,yBAHa,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;;OAOG;IACH,mBAHa,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,iBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,wBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,wBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;;OAQG;IACH,+BAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,SAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;OAOG;IACH,gBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAazB;CACF"}
+{"version":3,"file":"singleClick.d.ts","sourceRoot":"","sources":["../../../../../lib/core/engine/command/mouse/singleClick.js"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH;IACE,gEAiBC;IAhBC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,gBAAgE;IAChE;;OAEG;IACH,0BAA0C;IAC1C;;OAEG;IACH,gBAAsB;IAGxB;;OAEG;IACH,wBAKC;IAED;;;;;;;;;OASG;IACH,cANW,MAAM,YAEd;QAA0B,iBAAiB,GAAnC,OAAO;KACf,GAAU,OAAO,CAAC,IAAI,CAAC,CAqBzB;IAED;;OAEG;IACH,iBAGC;IAED;;;;;;;;;OASG;IACH,gBAoBC;IAED;;;;;;;;OAQG;IACH,uBAEC;IAED;;;;;;;;;OASG;IACH,mBAoBC;IAED;;;;;;;;OAQG;IACH,0BAEC;IAED;;;;;;;;OAQG;IACH,iBAiBC;IAED;;;;;;;;OAQG;IACH,wBAEC;IAED;;;;;;;;OAQG;IACH,mBAQC;IAED;;;;;;;;OAQG;IACH,0BAQC;IAED;;;;;;;;OAQG;IACH,0BAQC;IAED;;;;;;;;;OASG;IACH,iCAQC;IAED;;;;;;;;OAQG;IACH,aAYC;IAED;;;;;;;;OAQG;IACH,oBAEC;CACF"}

package/types/core/engine/command/navigation.d.ts

@@ -19,7 +19,7 @@ export class Navigation {
      *
      * @async
      * @example await commands.navigation.back();
-     * @param {Object} [options] - Additional options for navigation. Set {wait:true} to wait for the page complete check to run.
+     * @param {Object} [options] - Additional options for navigation. Set {waitForNavigation:true} to wait for the page complete check to run.
      * @returns {Promise<void>} A promise that resolves when the navigation action is completed.
      * @throws {Error} Throws an error if navigation fails.
      */
@@ -29,7 +29,7 @@ export class Navigation {
      *
      * @async
      * @example await commands.navigation.forward();
-     * @param {Object} [options] - Additional options for navigation. Set {wait:true} to wait for the page complete check to run.
+     * @param {Object} [options] - Additional options for navigation. Set {waitForNavigation:true} to wait for the page complete check to run.
      * @returns {Promise<void>} A promise that resolves when the navigation action is completed.
      * @throws {Error} Throws an error if navigation fails.
      */
@@ -39,7 +39,7 @@ export class Navigation {
      *
      * @async
      * @example await commands.navigation.refresh();
-     * @param {Object} [options] - Additional options for refresh action. Set {wait:true} to wait for the page complete check to run.
+     * @param {Object} [options] - Additional options for refresh action. Set {waitForNavigation:true} to wait for the page complete check to run.
      * @returns {Promise<void>} A promise that resolves when the page has been refreshed.
      * @throws {Error} Throws an error if refreshing the page fails.
      */

package/types/core/engine/command/select.d.ts

@@ -5,77 +5,114 @@
  * @hideconstructor
  */
 export class Select {
-    constructor(browser: any);
+    constructor(browser: any, options: any);
     /**
      * @private
      */
     private browser;
+    /**
+     * @private
+     */
+    private options;
+    /**
+     * @private
+     */
+    private _waitForElement;
+    /**
+     * Selects an option in a select element using a unified selector string and a value.
+     * Supports CSS selectors (default), and prefix-based strategies:
+     * 'id:mySelect', 'name:country', 'class:dropdown'.
+     *
+     * @async
+     * @param {string} selector - The selector string for the select element.
+     * @param {string} value - The value of the option to select.
+     * @returns {Promise<void>} A promise that resolves when the option is selected.
+     * @throws {Error} Throws an error if the select element is not found.
+     */
+    run(selector: string, value: string): Promise<void>;
+    /**
+     * Selects an option in a select element by its visible text using a unified selector string.
+     *
+     * @async
+     * @param {string} selector - The selector string for the select element.
+     * @param {string} text - The visible text of the option to select.
+     * @returns {Promise<void>} A promise that resolves when the option is selected.
+     * @throws {Error} Throws an error if the select element or option is not found.
+     */
+    runByText(selector: string, text: string): Promise<void>;
     /**
      * Selects an option in a `<select>` element by its ID and the value of the option.
      *
      * @async
+     * @private
      * @param {string} selectId - The ID of the `<select>` element.
      * @param {string} value - The value of the option to select.
      * @returns {Promise<void>} A promise that resolves when the option is selected.
      * @throws {Error} Throws an error if the `<select>` element is not found.
      */
-    selectByIdAndValue(selectId: string, value: string): Promise<void>;
+    private selectByIdAndValue;
     /**
      * Selects an option in a `<select>` element by its name and the value of the option.
      *
      * @async
+     * @private
      * @param {string} selectName - The name of the `<select>` element.
      * @param {string} value - The value of the option to select.
      * @returns {Promise<void>} A promise that resolves when the option is selected.
      * @throws {Error} Throws an error if the `<select>` element is not found.
      */
-    selectByNameAndValue(selectName: string, value: string): Promise<void>;
+    private selectByNameAndValue;
     /**
      * Selects an option in a `<select>` element by its ID and the index of the option.
      *
      * @async
+     * @private
      * @param {string} selectId - The ID of the `<select>` element.
      * @param {number} index - The index of the option to select.
      * @returns {Promise<void>} A promise that resolves when the option is selected.
      * @throws {Error} Throws an error if the `<select>` element is not found.
      */
-    selectByIdAndIndex(selectId: string, index: number): Promise<void>;
+    private selectByIdAndIndex;
     /**
      * Selects an option in a `<select>` element by its name and the index of the option.
      *
      * @async
+     * @private
      * @param {string} selectName - The name of the `<select>` element.
      * @param {number} index - The index of the option to select.
      * @returns {Promise<void>} A promise that resolves when the option is selected.
      * @throws {Error} Throws an error if the `<select>` element is not found.
      */
-    selectByNameAndIndex(selectName: string, index: number): Promise<void>;
+    private selectByNameAndIndex;
     /**
      * Deselects all options in a `<select>` element by its ID.
      *
      * @async
+     * @private
      * @param {string} selectId - The ID of the `<select>` element.
      * @returns {Promise<void>} A promise that resolves when all options are deselected.
      * @throws {Error} Throws an error if the `<select>` element is not found.
      */
-    deselectById(selectId: string): Promise<void>;
+    private deselectById;
     /**
      * Retrieves all option values in a `<select>` element by its ID.
      *
      * @async
+     * @private
      * @param {string} selectId - The ID of the `<select>` element.
      * @returns {Promise<string[]>} A promise that resolves with an array of the values of the options.
      * @throws {Error} Throws an error if the `<select>` element is not found.
      */
-    getValuesById(selectId: string): Promise<string[]>;
+    private getValuesById;
     /**
      * Retrieves the value of the selected option in a `<select>` element by its ID.
      *
      * @async
+     * @private
      * @param {string} selectId - The ID of the `<select>` element.
      * @returns {Promise<string>} A promise that resolves with the value of the selected option.
      * @throws {Error} Throws an error if the `<select>` element is not found.
      */
-    getSelectedValueById(selectId: string): Promise<string>;
+    private getSelectedValueById;
 }
 //# sourceMappingURL=select.d.ts.map

package/types/core/engine/command/select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/select.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IACE,0BAKC;IAJC;;OAEG;IACH,gBAAsB;IAGxB;;;;;;;;OAQG;IACH,6BALW,MAAM,SACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;;OAQG;IACH,iCALW,MAAM,SACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAczB;IAED;;;;;;;;OAQG;IACH,6BALW,MAAM,SACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAgBzB;IAED;;;;;;;;OAQG;IACH,iCALW,MAAM,SACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAgBzB;IAED;;;;;;;OAOG;IACH,uBAJW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAazB;IAED;;;;;;;OAOG;IACH,wBAJW,MAAM,GACJ,OAAO,CAAC,MAAM,EAAE,CAAC,CAoB7B;IAED;;;;;;;OAOG;IACH,+BAJW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAa3B;CACF"}
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/select.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH;IACE,wCASC;IARC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,gBAAsB;IAGxB;;OAEG;IACH,wBAKC;IAED;;;;;;;;;;OAUG;IACH,cALW,MAAM,SACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAoBzB;IAED;;;;;;;;OAQG;IACH,oBALW,MAAM,QACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CA8BzB;IAED;;;;;;;;;OASG;IACH,2BASC;IAED;;;;;;;;;OASG;IACH,6BAWC;IAED;;;;;;;;;OASG;IACH,2BAaC;IAED;;;;;;;;;OASG;IACH,6BAaC;IAED;;;;;;;;OAQG;IACH,qBAUC;IAED;;;;;;;;OAQG;IACH,sBAiBC;IAED;;;;;;;;OAQG;IACH,6BAUC;CACF"}

package/types/core/engine/command/selectorParser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Parses a selector string into a Selenium By locator.
+ * Supports prefix-based strategies:
+ * - 'id:value' -> By.id('value')
+ * - 'xpath:expression' -> By.xpath('expression')
+ * - 'name:value' -> By.name('value')
+ * - 'text:value' -> By.xpath('//*[normalize-space(text())="value"]')
+ * - 'link:value' -> By.xpath('//a[text()="value"]')
+ * - 'class:value' -> By.className('value')
+ * - No prefix -> By.css(selector) (CSS selector is the default)
+ *
+ * @param {string} selector - The selector string to parse.
+ * @returns {{ locator: By, description: string }} The parsed locator and a human-readable description.
+ */
+export function parseSelector(selector: string): {
+    locator: By;
+    description: string;
+};
+import { By } from 'selenium-webdriver';
+//# sourceMappingURL=selectorParser.d.ts.map

package/types/core/engine/command/selectorParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectorParser.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/selectorParser.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wCAHW,MAAM,GACJ;IAAE,OAAO,EAAE,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA2ChD;mBAzDkB,oBAAoB"}

package/types/core/engine/command/set.d.ts

@@ -5,70 +5,97 @@
  * @hideconstructor
  */
 export class Set {
-    constructor(browser: any);
+    constructor(browser: any, options: any);
     /**
      * @private
      */
     private browser;
+    /**
+     * @private
+     */
+    private options;
+    /**
+     * @private
+     */
+    private _waitForElement;
+    /**
+     * Sets a property on an element using a unified selector string.
+     * Supports CSS selectors (default), and prefix-based strategies:
+     * 'id:myId', 'xpath://input', 'name:field', 'class:input-field'.
+     *
+     * @async
+     * @param {string} selector - The selector string for the element.
+     * @param {string} value - The value to set.
+     * @param {string} [property='value'] - The property to set: 'value', 'innerText', or 'innerHTML'.
+     * @returns {Promise<void>} A promise that resolves when the property is set.
+     * @throws {Error} Throws an error if the element is not found.
+     */
+    run(selector: string, value: string, property?: string): Promise<void>;
     /**
      * Sets the innerHTML of an element using a CSS selector.
      *
      * @async
+     * @private
      * @param {string} html - The HTML string to set as innerHTML.
      * @param {string} selector - The CSS selector of the element.
      * @returns {Promise<void>} A promise that resolves when the innerHTML is set.
      * @throws {Error} Throws an error if the element is not found.
      */
-    innerHtml(html: string, selector: string): Promise<void>;
+    private innerHtml;
     /**
      * Sets the innerHTML of an element using its ID.
      *
      * @async
+     * @private
      * @param {string} html - The HTML string to set as innerHTML.
      * @param {string} id - The ID of the element.
      * @returns {Promise<void>} A promise that resolves when the innerHTML is set.
      * @throws {Error} Throws an error if the element is not found.
      */
-    innerHtmlById(html: string, id: string): Promise<void>;
+    private innerHtmlById;
     /**
      * Sets the innerText of an element using a CSS selector.
      *
      * @async
+     * @private
      * @param {string} text - The text to set as innerText.
      * @param {string} selector - The CSS selector of the element.
      * @returns {Promise<void>} A promise that resolves when the innerText is set.
      * @throws {Error} Throws an error if the element is not found.
      */
-    innerText(text: string, selector: string): Promise<void>;
+    private innerText;
     /**
      * Sets the innerText of an element using its ID.
      *
      * @async
+     * @private
      * @param {string} text - The text to set as innerText.
      * @param {string} id - The ID of the element.
      * @returns {Promise<void>} A promise that resolves when the innerText is set.
      * @throws {Error} Throws an error if the element is not found.
      */
-    innerTextById(text: string, id: string): Promise<void>;
+    private innerTextById;
     /**
      * Sets the value of an element using a CSS selector.
      *
      * @async
+     * @private
      * @param {string} value - The value to set on the element.
      * @param {string} selector - The CSS selector of the element.
      * @returns {Promise<void>} A promise that resolves when the value is set.
      * @throws {Error} Throws an error if the element is not found.
      */
-    value(value: string, selector: string): Promise<void>;
+    private value;
     /**
      * Sets the value of an element using its ID.
      *
      * @async
+     * @private
      * @param {string} value - The value to set on the element.
      * @param {string} id - The ID of the element.
      * @returns {Promise<void>} A promise that resolves when the value is set.
      * @throws {Error} Throws an error if the element is not found.
      */
-    valueById(value: string, id: string): Promise<void>;
+    private valueById;
 }
 //# sourceMappingURL=set.d.ts.map

package/types/core/engine/command/set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/set.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IACE,0BAKC;IAJC;;OAEG;IACH,gBAAsB;IAGxB;;;;;;;;OAQG;IACH,gBALW,MAAM,YACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAczB;IAED;;;;;;;;OAQG;IACH,oBALW,MAAM,MACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;;OAQG;IACH,gBALW,MAAM,YACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAczB;IAED;;;;;;;;OAQG;IACH,oBALW,MAAM,MACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;;OAQG;IACH,aALW,MAAM,YACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;;;;;;;OAQG;IACH,iBALW,MAAM,MACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;CACF"}
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../../lib/core/engine/command/set.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH;IACE,wCASC;IARC;;OAEG;IACH,gBAAsB;IACtB;;OAEG;IACH,gBAAsB;IAGxB;;OAEG;IACH,wBAKC;IAED;;;;;;;;;;;OAWG;IACH,cANW,MAAM,SACN,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAoBzB;IAED;;;;;;;;;OASG;IACH,kBAWC;IAED;;;;;;;;;OASG;IACH,sBASC;IAED;;;;;;;;;OASG;IACH,kBAWC;IAED;;;;;;;;;OASG;IACH,sBASC;IAED;;;;;;;;;OASG;IACH,cASC;IAED;;;;;;;;;OASG;IACH,kBASC;CACF"}