@oracle/oraclejet-webdriver 11.1.6 → 12.0.2

package/elements/oj-list-view/index.ts

@@ -1,27 +1,28 @@
-import { By } from "selenium-webdriver";
-import ojwd, { DriverLike, register } from "../../";
-import { OjListView } from "./OjListView";
+import { By } from 'selenium-webdriver';
+import { DriverLike, register } from '../../';
+import { OjListView } from './OjListView';
 export { OjListView };
 
 /**
- * Create an instance of [[OjListView]].  This function will first wait for
- * the element to appear in the DOM before trying to locate it.
+ * Retrieve an instance of [[OjListView]].
  * @example
- * <code>
- * const el = await ojListView(driver, By.id('my-oj-list-view'))
- * </code>
- * @param driver A WebDriver/WebElement instance used to locate the component
- * element.
- * @param by The By locator with which to find the element
+ * ```javascript
+ * import { ojListView } from '@oracle/oraclejet-webdriver/elements';
+ * const el = await ojListView(driver, By.id('my-oj-list-view'));
+ * ```
+ * @param driver A WebDriver/WebElement instance from where the element will be
+ * searched. If WebDriver is passed, the element will be searched globally in the
+ * document. If WebElement is passed, the search will be relative to this element.
+ * @param by The locator with which to find the element
  */
 export async function ojListView(driver: DriverLike, by: By): Promise<OjListView> {
   const webEl = await driver.findElement(by);
   // Check that the element is of type OjListView
   if (!(webEl instanceof OjListView)) {
     const tagName = await webEl.getTagName();
-    throw Error(`Locator '${by}' located a <${tagName}>, but expected <oj-list-view>`);
+    throw Error(`ojListView(${by}) create ${webEl.constructor.name} for <${tagName}>, but expected ${OjListView.name}`);
   }
   return webEl;
 }
 
-register("oj-list-view", OjListView);
+register('oj-list-view', OjListView);

package/elements/oj-masonry-layout/OjMasonryLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"OjMasonryLayout.js","sourceRoot":"","sources":["OjMasonryLayout.ts"],"names":[],"mappings":";;;AAAA,+DAA0D;AAS1D,MAAa,eAAgB,SAAQ,yCAAmB;CAEvD;AAFD,0CAEC"}
+{"version":3,"file":"OjMasonryLayout.js","sourceRoot":"","sources":["OjMasonryLayout.ts"],"names":[],"mappings":";;;AAAA,+DAA0D;AAO1D,MAAa,eAAgB,SAAQ,yCAAmB;CAEvD;AAFD,0CAEC"}

package/elements/oj-masonry-layout/OjMasonryLayout.ts

@@ -1,11 +1,9 @@
 import {OjMasonryLayoutBase} from "./OjMasonryLayoutBase";
 
 /**
- * This is the component WebElement for oj-masonry-layout. Retrieve an instance of the class
- * using its convenience function:
- * ```javascript
- * await ojMasonryLayout(driver, By.css('oj-masonry-layout'))
- * ```
+ * The component WebElement for [oj-masonry-layout](../../jsdocs/oj.ojMasonryLayout.html).
+ * Do not instantiate this class directly, instead, use
+ * [ojMasonryLayout](../modules/elements.html#ojMasonryLayout).
  */
 export class OjMasonryLayout extends OjMasonryLayoutBase {
   // Put overrides here

package/elements/oj-masonry-layout/OjMasonryLayoutBase.js

@@ -4,10 +4,10 @@ exports.OjMasonryLayoutBase = void 0;
 const __1 = require("../");
 class OjMasonryLayoutBase extends __1.OjWebElement {
     getReorderHandle() {
-        return this.getProperty("reorderHandle");
+        return this.getProperty('reorderHandle');
     }
     getTranslations() {
-        return this.getProperty("translations");
+        return this.getProperty('translations');
     }
 }
 exports.OjMasonryLayoutBase = OjMasonryLayoutBase;

package/elements/oj-masonry-layout/OjMasonryLayoutBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"OjMasonryLayoutBase.js","sourceRoot":"","sources":["OjMasonryLayoutBase.ts"],"names":[],"mappings":";;;AAAA,2BAAiC;AASjC,MAAa,mBAAoB,SAAQ,gBAAY;IAO5C,gBAAgB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAS,eAAe,CAAC,CAAC;IACnD,CAAC;IAQM,eAAe;QACpB,OAAO,IAAI,CAAC,WAAW,CAAwC,cAAc,CAAC,CAAC;IACjF,CAAC;CAEF;AArBD,kDAqBC"}
+{"version":3,"file":"OjMasonryLayoutBase.js","sourceRoot":"","sources":["OjMasonryLayoutBase.ts"],"names":[],"mappings":";;;AAAA,2BAAmC;AASnC,MAAa,mBAAoB,SAAQ,gBAAY;IAO5C,gBAAgB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAS,eAAe,CAAC,CAAC;IACnD,CAAC;IAQM,eAAe;QACpB,OAAO,IAAI,CAAC,WAAW,CAAoB,cAAc,CAAC,CAAC;IAC7D,CAAC;CAEF;AArBD,kDAqBC"}

package/elements/oj-masonry-layout/OjMasonryLayoutBase.ts

@@ -1,4 +1,4 @@
-import {OjWebElement} from "../";
+import { OjWebElement } from '../';
 
 /**
  * This is the base class for OjMasonryLayout, and is generated from
@@ -9,40 +9,37 @@ import {OjWebElement} from "../";
  */
 export class OjMasonryLayoutBase extends OjWebElement {
   /**
-   * Gets the value of reorderHandle property.
+   * Gets the value of <code>reorderHandle</code> property.
    * Specifies the selector of the child DOM element that can be used to reorder the child.
-   * @return The value of reorderHandle property.
+   * @return The value of <code>reorderHandle</code> property.
    * 
    */
   public getReorderHandle(): Promise<string> {
-    return this.getProperty<string>("reorderHandle");
+    return this.getProperty<string>('reorderHandle');
   }
 
   /**
-   * Gets the value of translations property.
+   * Gets the value of <code>translations</code> property.
    * A collection of translated resources from the translation bundle, or null if this component has no resources.
-   * @return The value of translations property.
+   * @return The value of <code>translations</code> property.
    * 
    */
-  public getTranslations(): Promise<OjMasonryLayoutBase.Translations|null> {
-    return this.getProperty<OjMasonryLayoutBase.Translations|null>("translations");
+  public getTranslations(): Promise<Translations|null> {
+    return this.getProperty<Translations|null>('translations');
   }
 
 }
-
-namespace OjMasonryLayoutBase {
-  export interface Translations {
-    /**
-     * Context menu text used for cutting a tile.
-     */
-    "labelCut": string;
-    /**
-     * Context menu text used for pasting a tile after another tile.
-     */
-    "labelPasteAfter": string;
-    /**
-     * Context menu text used for pasting a tile before another tile.
-     */
-    "labelPasteBefore": string;
-  }
+export interface Translations {
+  /**
+   * Context menu text used for cutting a tile.
+   */
+  "labelCut": string;
+  /**
+   * Context menu text used for pasting a tile after another tile.
+   */
+  "labelPasteAfter": string;
+  /**
+   * Context menu text used for pasting a tile before another tile.
+   */
+  "labelPasteBefore": string;
 }

package/elements/oj-masonry-layout/index.js

@@ -8,10 +8,10 @@ async function ojMasonryLayout(driver, by) {
     const webEl = await driver.findElement(by);
     if (!(webEl instanceof OjMasonryLayout_1.OjMasonryLayout)) {
         const tagName = await webEl.getTagName();
-        throw Error(`Locator '${by}' located a <${tagName}>, but expected <oj-masonry-layout>`);
+        throw Error(`ojMasonryLayout(${by}) create ${webEl.constructor.name} for <${tagName}>, but expected ${OjMasonryLayout_1.OjMasonryLayout.name}`);
     }
     return webEl;
 }
 exports.ojMasonryLayout = ojMasonryLayout;
-__1.register("oj-masonry-layout", OjMasonryLayout_1.OjMasonryLayout);
+__1.register('oj-masonry-layout', OjMasonryLayout_1.OjMasonryLayout);
 //# sourceMappingURL=index.js.map

package/elements/oj-masonry-layout/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AACA,8BAAoD;AACpD,uDAAoD;AAC3C,gGADA,iCAAe,OACA;AAajB,KAAK,UAAU,eAAe,CAAC,MAAkB,EAAE,EAAM;IAC9D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE3C,IAAI,CAAC,CAAC,KAAK,YAAY,iCAAe,CAAC,EAAE;QACvC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,CAAC,YAAY,EAAE,gBAAgB,OAAO,qCAAqC,CAAC,CAAC;KACzF;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AARD,0CAQC;AAED,YAAQ,CAAC,mBAAmB,EAAE,iCAAe,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AACA,8BAA8C;AAC9C,uDAAoD;AAC3C,gGADA,iCAAe,OACA;AAcjB,KAAK,UAAU,eAAe,CAAC,MAAkB,EAAE,EAAM;IAC9D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE3C,IAAI,CAAC,CAAC,KAAK,YAAY,iCAAe,CAAC,EAAE;QACvC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,CAAC,mBAAmB,EAAE,YAAY,KAAK,CAAC,WAAW,CAAC,IAAI,SAAS,OAAO,mBAAmB,iCAAe,CAAC,IAAI,EAAE,CAAC,CAAC;KAC/H;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AARD,0CAQC;AAED,YAAQ,CAAC,mBAAmB,EAAE,iCAAe,CAAC,CAAC"}

package/elements/oj-masonry-layout/index.ts

@@ -1,27 +1,28 @@
-import { By } from "selenium-webdriver";
-import ojwd, { DriverLike, register } from "../../";
-import { OjMasonryLayout } from "./OjMasonryLayout";
+import { By } from 'selenium-webdriver';
+import { DriverLike, register } from '../../';
+import { OjMasonryLayout } from './OjMasonryLayout';
 export { OjMasonryLayout };
 
 /**
- * Create an instance of [[OjMasonryLayout]].  This function will first wait for
- * the element to appear in the DOM before trying to locate it.
+ * Retrieve an instance of [[OjMasonryLayout]].
  * @example
- * <code>
- * const el = await ojMasonryLayout(driver, By.id('my-oj-masonry-layout'))
- * </code>
- * @param driver A WebDriver/WebElement instance used to locate the component
- * element.
- * @param by The By locator with which to find the element
+ * ```javascript
+ * import { ojMasonryLayout } from '@oracle/oraclejet-webdriver/elements';
+ * const el = await ojMasonryLayout(driver, By.id('my-oj-masonry-layout'));
+ * ```
+ * @param driver A WebDriver/WebElement instance from where the element will be
+ * searched. If WebDriver is passed, the element will be searched globally in the
+ * document. If WebElement is passed, the search will be relative to this element.
+ * @param by The locator with which to find the element
  */
 export async function ojMasonryLayout(driver: DriverLike, by: By): Promise<OjMasonryLayout> {
   const webEl = await driver.findElement(by);
   // Check that the element is of type OjMasonryLayout
   if (!(webEl instanceof OjMasonryLayout)) {
     const tagName = await webEl.getTagName();
-    throw Error(`Locator '${by}' located a <${tagName}>, but expected <oj-masonry-layout>`);
+    throw Error(`ojMasonryLayout(${by}) create ${webEl.constructor.name} for <${tagName}>, but expected ${OjMasonryLayout.name}`);
   }
   return webEl;
 }
 
-register("oj-masonry-layout", OjMasonryLayout);
+register('oj-masonry-layout', OjMasonryLayout);

package/elements/oj-menu/OjMenu.js

@@ -23,6 +23,18 @@ class OjMenu extends OjMenuBase_1.OjMenuBase {
         await item.click();
         await this.whenBusyContextReady();
     }
+    async doMenuAction(selectedValue) {
+        await this.whenReady();
+        return this.getDriver().executeScript(`
+    const evt = new CustomEvent('ojMenuAction', {
+      detail: {
+        selectedValue: "${selectedValue}"
+      }
+    });
+    arguments[0].dispatchEvent(evt);
+    arguments[0].close();
+    `, this);
+    }
 }
 exports.OjMenu = OjMenu;
 //# sourceMappingURL=OjMenu.js.map

package/elements/oj-menu/OjMenu.js.map

@@ -1 +1 @@
-{"version":3,"file":"OjMenu.js","sourceRoot":"","sources":["OjMenu.ts"],"names":[],"mappings":";;;AAAA,2DAAuD;AACvD,6CAAwC;AASxC,MAAa,MAAO,SAAQ,uBAAU;IAMpC,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;QACtB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,uBAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC7D,MAAM,CAAC,CAAC,KAAK,EAAE,CAAA;QACf,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC;IAOD,KAAK,CAAC,eAAe,CAAC,EAAU;QAC9B,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;QACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,uBAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,uBAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;QACjE,OAAO,SAAS,KAAK,GAAG,EAAE;YACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,wBAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;SAC9D;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;QAClB,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC;CACF;AA/BD,wBA+BC"}
+{"version":3,"file":"OjMenu.js","sourceRoot":"","sources":["OjMenu.ts"],"names":[],"mappings":";;;AAAA,2DAAuD;AACvD,6CAAwC;AAOxC,MAAa,MAAO,SAAQ,uBAAU;IAMpC,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;QACtB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,uBAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC7D,MAAM,CAAC,CAAC,KAAK,EAAE,CAAA;QACf,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC;IAQD,KAAK,CAAC,eAAe,CAAC,EAAU;QAC9B,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;QACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,uBAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,uBAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;QACjE,OAAO,SAAS,KAAK,GAAG,EAAE;YACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,wBAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;SAC9D;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;QAClB,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC;IAMD,KAAK,CAAC,YAAY,CAAC,aAAqB;QACtC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;QACtB,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,aAAa,CAAO;;;0BAGtB,aAAa;;;;;KAKlC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC;CACF;AAjDD,wBAiDC"}

package/elements/oj-menu/OjMenu.ts

@@ -2,11 +2,9 @@ import {By, Key, WebElement} from "selenium-webdriver";
 import {OjMenuBase} from "./OjMenuBase";
 
 /**
- * This is the component WebElement for oj-menu. Retrieve an instance of the class
- * using its convenience function:
- * ```javascript
- * await ojMenu(driver, By.css('oj-menu'))
- * ```
+ * The component WebElement for [oj-menu](../../jsdocs/oj.ojMenu.html).
+ * Do not instantiate this class directly, instead, use
+ * [ojMenu](../modules/elements.html#ojMenu).
  */
 export class OjMenu extends OjMenuBase {
   /**
@@ -21,6 +19,7 @@ export class OjMenu extends OjMenuBase {
     await this.whenBusyContextReady();
   }
    /**
+    * @deprecated Since 12.0.0. Use doMenuAction instead
    * Select a menu item from the list.  Note that the menu must
    * first be opened with {@link #open} before an item can be
    * selected.
@@ -39,4 +38,21 @@ export class OjMenu extends OjMenuBase {
     await item.click()
     await this.whenBusyContextReady();
   }
+/**
+ * method causes the component to fire the ojMenuAction event
+ * @param selectedValue Value of the &ltl;oj-option> to select
+ *
+ */
+  async doMenuAction(selectedValue: string ) {
+    await this.whenReady()
+    return this.getDriver().executeScript<void>(`
+    const evt = new CustomEvent('ojMenuAction', {
+      detail: {
+        selectedValue: "${selectedValue}"
+      }
+    });
+    arguments[0].dispatchEvent(evt);
+    arguments[0].close();
+    `, this);
+  }
 }

package/elements/oj-menu/OjMenuBase.js

@@ -4,13 +4,13 @@ exports.OjMenuBase = void 0;
 const __1 = require("../");
 class OjMenuBase extends __1.OjWebElement {
     getDisabled() {
-        return this.getProperty("disabled");
+        return this.getProperty('disabled');
     }
     getOpenOptions() {
-        return this.getProperty("openOptions");
+        return this.getProperty('openOptions');
     }
     getTranslations() {
-        return this.getProperty("translations");
+        return this.getProperty('translations');
     }
 }
 exports.OjMenuBase = OjMenuBase;

package/elements/oj-menu/OjMenuBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"OjMenuBase.js","sourceRoot":"","sources":["OjMenuBase.ts"],"names":[],"mappings":";;;AAAA,2BAAiC;AASjC,MAAa,UAAW,SAAQ,gBAAY;IAOnC,WAAW;QAChB,OAAO,IAAI,CAAC,WAAW,CAAU,UAAU,CAAC,CAAC;IAC/C,CAAC;IAQM,cAAc;QACnB,OAAO,IAAI,CAAC,WAAW,CAAyB,aAAa,CAAC,CAAC;IACjE,CAAC;IAQM,eAAe;QACpB,OAAO,IAAI,CAAC,WAAW,CAA+B,cAAc,CAAC,CAAC;IACxE,CAAC;CAEF;AA/BD,gCA+BC"}
+{"version":3,"file":"OjMenuBase.js","sourceRoot":"","sources":["OjMenuBase.ts"],"names":[],"mappings":";;;AAAA,2BAAmC;AASnC,MAAa,UAAW,SAAQ,gBAAY;IAOnC,WAAW;QAChB,OAAO,IAAI,CAAC,WAAW,CAAU,UAAU,CAAC,CAAC;IAC/C,CAAC;IAQM,cAAc;QACnB,OAAO,IAAI,CAAC,WAAW,CAAc,aAAa,CAAC,CAAC;IACtD,CAAC;IAQM,eAAe;QACpB,OAAO,IAAI,CAAC,WAAW,CAAoB,cAAc,CAAC,CAAC;IAC7D,CAAC;CAEF;AA/BD,gCA+BC"}

package/elements/oj-menu/OjMenuBase.ts

@@ -1,4 +1,4 @@
-import {OjWebElement} from "../";
+import { OjWebElement } from '../';
 
 /**
  * This is the base class for OjMenu, and is generated from
@@ -9,116 +9,113 @@ import {OjWebElement} from "../";
  */
 export class OjMenuBase extends OjWebElement {
   /**
-   * Gets the value of disabled property.
+   * Gets the value of <code>disabled</code> property.
    * Disables the menu if set to true.
-   * @return The value of disabled property.
+   * @return The value of <code>disabled</code> property.
    * 
    */
   public getDisabled(): Promise<boolean> {
-    return this.getProperty<boolean>("disabled");
+    return this.getProperty<boolean>('disabled');
   }
 
   /**
-   * Gets the value of openOptions property.
+   * Gets the value of <code>openOptions</code> property.
    * Specifies settings for launching a menu. See the Help documentation for more information.
-   * @return The value of openOptions property.
+   * @return The value of <code>openOptions</code> property.
    * 
    */
-  public getOpenOptions(): Promise<OjMenuBase.OpenOptions> {
-    return this.getProperty<OjMenuBase.OpenOptions>("openOptions");
+  public getOpenOptions(): Promise<OpenOptions> {
+    return this.getProperty<OpenOptions>('openOptions');
   }
 
   /**
-   * Gets the value of translations property.
+   * Gets the value of <code>translations</code> property.
    * A collection of translated resources from the translation bundle, or null if this component has no resources.
-   * @return The value of translations property.
+   * @return The value of <code>translations</code> property.
    * 
    */
-  public getTranslations(): Promise<OjMenuBase.Translations|null> {
-    return this.getProperty<OjMenuBase.Translations|null>("translations");
+  public getTranslations(): Promise<Translations|null> {
+    return this.getProperty<Translations|null>('translations');
   }
 
 }
-
-namespace OjMenuBase {
-  export interface OpenOptions {
-    /**
-     * Specifies whether the menu displays as a drop down or as a sheet. See the Help documentation for more information.
-     */
-    "display": string;
-    /**
-     * Specifies focus behavior when the menu is initially opened.
-     */
-    "initialFocus": string;
-    /**
-     * Specifies the DOM node that launches this menu. See the Help documentation for more information.
-     */
-    "launcher": string;
-    /**
-     * Specifies the position of a drop down menu when launched. See the Help documentation for more information.
-     */
-    "position": OjMenuBase.OpenOptionsPosition;
-  }
-  export interface OpenOptionsPosition {
-    /**
-     * Defines which position on the target element ("of") to align the positioned element against.
-     */
-    "at": OjMenuBase.OpenOptionsPositionAt;
-    /**
-     * Rule for alternate alignment.
-     */
-    "collision": string;
-    /**
-     * Defines which edge on the menu to align with the target ("of") element.
-     */
-    "my": OjMenuBase.OpenOptionsPositionMy;
-    /**
-     * Which element to position the menu against. See the Help documentation for more information.
-     */
-    "of": string|object;
-    /**
-     * Defines a point offset in pixels from the ("my") alignment.
-     */
-    "offset": OjMenuBase.OpenOptionsPositionOffset;
-  }
-  export interface OpenOptionsPositionAt {
-    /**
-     * Defines the horizontal alignment of what the menu is aligned to. See the Help documentation for more information.
-     */
-    "horizontal": string;
-    /**
-     * Defines the vertical alignment of what the menu is aligned to. See the Help documentation for more information.
-     */
-    "vertical": string;
-  }
-  export interface OpenOptionsPositionMy {
-    /**
-     * Defines the horizontal alignment of the menu.
-     */
-    "horizontal": string;
-    /**
-     * Defines the vertical alignment of the menu.
-     */
-    "vertical": string;
-  }
-  export interface OpenOptionsPositionOffset {
-    /**
-     * Horizontal alignment offset.
-     */
-    "x": number;
-    /**
-     * Vertical alignment offset.
-     */
-    "y": number;
-  }
-  export interface Translations {
-    /**
-     * Label assigned to a hidden anchor tag used for accessibility navigation on platforms supporting VoiceOver. The link is injected before the first menu item. It is used for establishing VO cursor focus. Activation of the link will move focus to the first menu item.
-     */
-    "ariaFocusSkipLink": string;
-    /**
-     * Label for the "Cancel" menu item.
-     */
-    "labelCancel": string;
-  }
+export interface OpenOptions {
+  /**
+   * Specifies whether the menu displays as a drop down or as a sheet. See the Help documentation for more information.
+   */
+  "display": string;
+  /**
+   * Specifies focus behavior when the menu is initially opened.
+   */
+  "initialFocus": string;
+  /**
+   * Specifies the DOM node that launches this menu. See the Help documentation for more information.
+   */
+  "launcher": string;
+  /**
+   * Specifies the position of a drop down menu when launched. See the Help documentation for more information.
+   */
+  "position": OpenOptionsPosition;
+}
+export interface OpenOptionsPosition {
+  /**
+   * Defines which position on the target element ("of") to align the positioned element against.
+   */
+  "at": OpenOptionsPositionAt;
+  /**
+   * Rule for alternate alignment.
+   */
+  "collision": string;
+  /**
+   * Defines which edge on the menu to align with the target ("of") element.
+   */
+  "my": OpenOptionsPositionMy;
+  /**
+   * Which element to position the menu against. See the Help documentation for more information.
+   */
+  "of": string|object;
+  /**
+   * Defines a point offset in pixels from the ("my") alignment.
+   */
+  "offset": OpenOptionsPositionOffset;
+}
+export interface OpenOptionsPositionAt {
+  /**
+   * Defines the horizontal alignment of what the menu is aligned to. See the Help documentation for more information.
+   */
+  "horizontal": string;
+  /**
+   * Defines the vertical alignment of what the menu is aligned to. See the Help documentation for more information.
+   */
+  "vertical": string;
+}
+export interface OpenOptionsPositionMy {
+  /**
+   * Defines the horizontal alignment of the menu.
+   */
+  "horizontal": string;
+  /**
+   * Defines the vertical alignment of the menu.
+   */
+  "vertical": string;
+}
+export interface OpenOptionsPositionOffset {
+  /**
+   * Horizontal alignment offset.
+   */
+  "x": number;
+  /**
+   * Vertical alignment offset.
+   */
+  "y": number;
+}
+export interface Translations {
+  /**
+   * Label assigned to a hidden anchor tag used for accessibility navigation on platforms supporting VoiceOver. The link is injected before the first menu item. It is used for establishing VO cursor focus. Activation of the link will move focus to the first menu item.
+   */
+  "ariaFocusSkipLink": string;
+  /**
+   * Label for the "Cancel" menu item.
+   */
+  "labelCancel": string;
 }

package/elements/oj-menu/index.js

@@ -8,10 +8,10 @@ async function ojMenu(driver, by) {
     const webEl = await driver.findElement(by);
     if (!(webEl instanceof OjMenu_1.OjMenu)) {
         const tagName = await webEl.getTagName();
-        throw Error(`Locator '${by}' located a <${tagName}>, but expected <oj-menu>`);
+        throw Error(`ojMenu(${by}) create ${webEl.constructor.name} for <${tagName}>, but expected ${OjMenu_1.OjMenu.name}`);
     }
     return webEl;
 }
 exports.ojMenu = ojMenu;
-__1.register("oj-menu", OjMenu_1.OjMenu);
+__1.register('oj-menu', OjMenu_1.OjMenu);
 //# sourceMappingURL=index.js.map

package/elements/oj-menu/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AACA,8BAAoD;AACpD,qCAAkC;AACzB,uFADA,eAAM,OACA;AAaR,KAAK,UAAU,MAAM,CAAC,MAAkB,EAAE,EAAM;IACrD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE3C,IAAI,CAAC,CAAC,KAAK,YAAY,eAAM,CAAC,EAAE;QAC9B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,CAAC,YAAY,EAAE,gBAAgB,OAAO,2BAA2B,CAAC,CAAC;KAC/E;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AARD,wBAQC;AAED,YAAQ,CAAC,SAAS,EAAE,eAAM,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AACA,8BAA8C;AAC9C,qCAAkC;AACzB,uFADA,eAAM,OACA;AAcR,KAAK,UAAU,MAAM,CAAC,MAAkB,EAAE,EAAM;IACrD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE3C,IAAI,CAAC,CAAC,KAAK,YAAY,eAAM,CAAC,EAAE;QAC9B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,CAAC,UAAU,EAAE,YAAY,KAAK,CAAC,WAAW,CAAC,IAAI,SAAS,OAAO,mBAAmB,eAAM,CAAC,IAAI,EAAE,CAAC,CAAC;KAC7G;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AARD,wBAQC;AAED,YAAQ,CAAC,SAAS,EAAE,eAAM,CAAC,CAAC"}

package/elements/oj-menu/index.ts

@@ -1,27 +1,28 @@
-import { By } from "selenium-webdriver";
-import ojwd, { DriverLike, register } from "../../";
-import { OjMenu } from "./OjMenu";
+import { By } from 'selenium-webdriver';
+import { DriverLike, register } from '../../';
+import { OjMenu } from './OjMenu';
 export { OjMenu };
 
 /**
- * Create an instance of [[OjMenu]].  This function will first wait for
- * the element to appear in the DOM before trying to locate it.
+ * Retrieve an instance of [[OjMenu]].
  * @example
- * <code>
- * const el = await ojMenu(driver, By.id('my-oj-menu'))
- * </code>
- * @param driver A WebDriver/WebElement instance used to locate the component
- * element.
- * @param by The By locator with which to find the element
+ * ```javascript
+ * import { ojMenu } from '@oracle/oraclejet-webdriver/elements';
+ * const el = await ojMenu(driver, By.id('my-oj-menu'));
+ * ```
+ * @param driver A WebDriver/WebElement instance from where the element will be
+ * searched. If WebDriver is passed, the element will be searched globally in the
+ * document. If WebElement is passed, the search will be relative to this element.
+ * @param by The locator with which to find the element
  */
 export async function ojMenu(driver: DriverLike, by: By): Promise<OjMenu> {
   const webEl = await driver.findElement(by);
   // Check that the element is of type OjMenu
   if (!(webEl instanceof OjMenu)) {
     const tagName = await webEl.getTagName();
-    throw Error(`Locator '${by}' located a <${tagName}>, but expected <oj-menu>`);
+    throw Error(`ojMenu(${by}) create ${webEl.constructor.name} for <${tagName}>, but expected ${OjMenu.name}`);
   }
   return webEl;
 }
 
-register("oj-menu", OjMenu);
+register('oj-menu', OjMenu);

package/elements/oj-menu-button/OjMenuButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"OjMenuButton.js","sourceRoot":"","sources":["OjMenuButton.ts"],"names":[],"mappings":";;;AAAA,2DAAsC;AACtC,yDAAoD;AASpD,MAAa,YAAa,SAAQ,mCAAgB;IAIhD,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;QACtB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,uBAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAClD,MAAM,CAAC,CAAC,KAAK,EAAE,CAAA;IACjB,CAAC;CACF;AATD,oCASC"}
+{"version":3,"file":"OjMenuButton.js","sourceRoot":"","sources":["OjMenuButton.ts"],"names":[],"mappings":";;;AAAA,2DAAsC;AACtC,yDAAoD;AAOpD,MAAa,YAAa,SAAQ,mCAAgB;IAIhD,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;QACtB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,uBAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAClD,MAAM,CAAC,CAAC,KAAK,EAAE,CAAA;IACjB,CAAC;CACF;AATD,oCASC"}

package/elements/oj-menu-button/OjMenuButton.ts

@@ -2,11 +2,9 @@ import {By} from "selenium-webdriver";
 import {OjMenuButtonBase} from "./OjMenuButtonBase";
 
 /**
- * This is the component WebElement for oj-menu-button. Retrieve an instance of the class
- * using its convenience function:
- * ```javascript
- * await ojMenuButton(driver, By.css('oj-menu-button'))
- * ```
+ * The component WebElement for [oj-menu-button](../../jsdocs/oj.ojMenuButton.html).
+ * Do not instantiate this class directly, instead, use
+ * [ojMenuButton](../modules/elements.html#ojMenuButton).
  */
 export class OjMenuButton extends OjMenuButtonBase {
   /**