@oracle/oraclejet-webdriver 17.1.4 → 18.0.1

package/{elements → src/elements}/oj-navigation-list/OjNavigationList.ts

@@ -24,12 +24,10 @@ export class OjNavigationList extends OjNavigationListBase {
       this.getDriver(),
       ['KeySet'],
       [this, expanded],
-      `
-      (({ ExpandedKeySet }, ele, expanded) => {
+      ({ ExpandedKeySet }, ele, expanded) => {
         const expandedKeySet = new ExpandedKeySet(expanded);
         ele.expanded = expandedKeySet;
-      })
-      `
+      }
     );
   }
   /*
@@ -41,97 +39,99 @@ export class OjNavigationList extends OjNavigationListBase {
     this.whenReady();
     let expansionTree: any = this._getExpansionTree(indexes);
     await this.getDriver().executeScript(
-      [
-        /* Reference to the current nav list */
-        'var ele = arguments[0]',
-
-        /* Expansiontree(type object) of given index array */
-        'let expansionTree = arguments[1];',
-
-        '_traverseListToExpand(null, expansionTree);',
+      (ele: any, expansionTree: any) => {
+        _traverseListToExpand(null, expansionTree);
 
         /* Check it has collapsed class */
-        ' function _isCollapsed(item) {',
-        '  return _hasClass(item,"oj-collapsed");',
-        ' }',
+        function _isCollapsed(item: Element) {
+          return _hasClass(item, 'oj-collapsed');
+        }
         /* Check it has expanded class */
-        ' function _isExpanded(item) {',
-        '  return _hasClass(item,"oj-expanded");',
-        ' }',
+        function _isExpanded(item: Element) {
+          return _hasClass(item, 'oj-expanded');
+        }
         /* Expand the item if it is not exapanded */
-        ' function  expandItem(item) {',
-        '  let isExpanded = _isExpanded(item);',
-        '  if (!isExpanded) {',
-        '   var collapsedIcon = item.querySelector(".oj-navigationlist-collapse-icon");',
-        '   collapsedIcon.click();',
-        '  }',
-        ' }',
+        function expandItem(item: Element) {
+          let isExpanded = _isExpanded(item);
+          if (!isExpanded) {
+            var collapsedIcon = item.querySelector('.oj-navigationlist-collapse-icon') as any;
+            collapsedIcon?.click();
+          }
+        }
         /* Collapse the item if it is not collapsed */
-        ' function collapseItem(item) {',
-        '  let isCollapsed = _isCollapsed(item);',
-        '  if (!isCollapsed) {',
-        '   var expandedIcon = item.querySelector(".oj-navigationlist-expand-icon");',
-        '   expandedIcon.click();',
-        '  }',
-        ' }',
+        function collapseItem(item: Element) {
+          let isCollapsed = _isCollapsed(item);
+          if (!isCollapsed) {
+            var expandedIcon = item.querySelector('.oj-navigationlist-expand-icon') as any;
+            expandedIcon?.click();
+          }
+        }
         /* Check given class name in element */
-        ' function _hasClass(element, className) {',
-        ' let classes =  element.getAttribute("class");',
-        ' let hasClass = false;',
-        ' classes.split(" ").forEach(c => {',
-        '  if (c === className) {',
-        '   hasClass = true;',
-        '  }',
-        ' });',
-        ' return hasClass;',
-        ' }',
+        function _hasClass(element: Element, className: string) {
+          let classes = element.getAttribute('class');
+          let hasClass = false;
+          classes?.split(' ').forEach((c) => {
+            if (c === className) {
+              hasClass = true;
+            }
+          });
+          return hasClass;
+        }
         /* Get the element by its index */
-        ' function getItemByIndex(index, parent){',
-        ' let item;',
-        '  if (!parent)',
-        '   item = ele.querySelector(".oj-navigationlist-element > .oj-navigationlist-item-element:nth-child(" + index + ")")',
-        '  else {',
-        '   item = parent.querySelector(".oj-navigationlist-group > .oj-navigationlist-item-element:nth-child(" + index + ")")',
-        '  }',
-        ' return item;',
-        ' }',
+        function getItemByIndex(index: number, parent: Element) {
+          let item;
+          if (!parent)
+            item = ele.querySelector(
+              '.oj-navigationlist-element > .oj-navigationlist-item-element:nth-child(' +
+                index +
+                ')'
+            );
+          else {
+            item = parent.querySelector(
+              '.oj-navigationlist-group > .oj-navigationlist-item-element:nth-child(' + index + ')'
+            );
+          }
+          return item;
+        }
         /* This will check should item be exapanded only if present in exapasion tree*/
-        ' function  shouldBeExpanded(expansionTree, indexPath){',
-        '  if (indexPath.length === 0) {',
-        '   return false;',
-        '  }',
-        '  for (let i=0; i < indexPath.length; i++) {',
-        '  expansionTree = expansionTree[indexPath[i]];',
-        '   if (!expansionTree) {',
-        '    return false;',
-        '   }',
-        '  }',
-        ' return true;',
-        ' }',
+        function shouldBeExpanded(expansionTree: any, indexPath: any[]) {
+          if (indexPath.length === 0) {
+            return false;
+          }
+          for (let i = 0; i < indexPath.length; i++) {
+            expansionTree = expansionTree[indexPath[i]];
+            if (!expansionTree) {
+              return false;
+            }
+          }
+          return true;
+        }
         /* Expands items specified by index path
          This also collapses all other nodes if any expanded already */
-        ' function _traverseListToExpand(parent, expansionTree, parentIndexPath) {',
-        '  let item, indexPath, index = 1;',
-        '  item =  getItemByIndex(index, parent);',
-        '  parentIndexPath = parentIndexPath && parentIndexPath.length > 0 ? parentIndexPath : []',
-        '  while (item) {',
-        '   let isExpanded =  _isExpanded(item);',
-        '   let isCollapsed = _isCollapsed(item);',
-        '     if (isCollapsed || isExpanded) {',
-        '       indexPath = parentIndexPath.concat([index])',
-        '       if (isCollapsed && shouldBeExpanded(expansionTree, indexPath)) {',
-        '           expandItem(item);',
-        '       }',
-        '     _traverseListToExpand(item, expansionTree, indexPath);',
-        '     if (isExpanded && !shouldBeExpanded(expansionTree, indexPath)) {',
-        '         collapseItem(item);',
-        '     }',
-        '   }',
-        '   index = index + 1;',
-        '   item =  getItemByIndex(index, parent);',
-        '  }',
-        ' }'
-      ].join('\n'),
+        function _traverseListToExpand(parent: any, expansionTree: any, parentIndexPath?: any[]) {
+          let item,
+            indexPath,
+            index = 1;
+          item = getItemByIndex(index, parent);
+          parentIndexPath = parentIndexPath && parentIndexPath.length > 0 ? parentIndexPath : [];
+          while (item) {
+            let isExpanded = _isExpanded(item);
+            let isCollapsed = _isCollapsed(item);
+            if (isCollapsed || isExpanded) {
+              indexPath = parentIndexPath.concat([index]);
+              if (isCollapsed && shouldBeExpanded(expansionTree, indexPath)) {
+                expandItem(item);
+              }
+              _traverseListToExpand(item, expansionTree, indexPath);
+              if (isExpanded && !shouldBeExpanded(expansionTree, indexPath)) {
+                collapseItem(item);
+              }
+            }
+            index = index + 1;
+            item = getItemByIndex(index, parent);
+          }
+        }
+      },
       this,
       expansionTree
     );
@@ -188,8 +188,8 @@ Use the ExpandAllKeySet class to expand all items.
    */
   async getExpanded(): Promise<Array<any>> {
     await this.whenReady();
-    let expanded: any = await this.getDriver().executeScript(
-      ['return Array.from(arguments[0].expanded.values());'].join('\n'),
+    let expanded = await this.getDriver().executeScript<any[]>(
+      (el: any) => Array.from(el.expanded.values()),
       this
     );
     return expanded;
@@ -263,12 +263,9 @@ Use the ExpandAllKeySet class to expand all items.
   async findItem<T>(itemLocator: { key: T }): Promise<SlotProxy> {
     // rendere in DOM
     const el = await this.getDriver().executeScript<WebElement>(
-      `
-    return arguments[0].getNodeBySubId({ subId: 'oj-navigationlist-item', key: ${JSON.stringify(
+      (ele: any, key: T) => ele.getNodeBySubId({ subId: 'oj-navigationlist-item', key }),
+      this,
       itemLocator.key
-    )} })
-    `,
-      this
     );
     return slotProxy(el, this);
   }

package/{elements → src/elements}/oj-navigation-list/OjNavigationListBase.ts

@@ -61,7 +61,7 @@ export class OjNavigationListBase extends OjWebElement {
    * Gets the value of <code>edge</code> property.
    * Specifies the edge position of the Navigation List.
    * @return The value of <code>edge</code> property.
-   * @deprecated Since 17.0.0. Horizontal layout in oj-navigation-list is deprecated. Use oj-tab-bar instead. Since start is the only supported and default value, it need not be specified using edge attribute.
+   * @deprecated Since 17.0.0. Support for horizontal layout in oj-navigation-list is deprecated - use oj-tab-bar instead.
    */
   public getEdge(): Promise<string> {
     return this.getProperty<string>('edge');
@@ -71,7 +71,7 @@ export class OjNavigationListBase extends OjWebElement {
    * Gets the value of <code>hierarchyMenuThreshold</code> property.
    * Specifies the level at which the user can see hierarchical menu button. See the Help documentation for more information.
    * @return The value of <code>hierarchyMenuThreshold</code> property.
-   * @deprecated Since 13.0.0. The hierarchyMenuThreshold property is deprecated as it is not supported in the Redwood theme.
+   * @deprecated Since 13.0.0. This is not supported in the Redwood theme.
    */
   public getHierarchyMenuThreshold(): Promise<number> {
     return this.getProperty<number>('hierarchyMenuThreshold');
@@ -91,7 +91,7 @@ export class OjNavigationListBase extends OjWebElement {
    * Gets the value of <code>overflow</code> property.
    * Specifies overflow behaviour for the Navigation List.
    * @return The value of <code>overflow</code> property.
-   * @deprecated Since 17.0.0. Since horizontal layout in oj-navigation-list is deprecated this should not be used any more. Use oj-tab-bar instead.
+   * @deprecated Since 17.0.0. Support for horizontal layout in oj-navigation-list is deprecated - use oj-tab-bar instead.
    */
   public getOverflow(): Promise<string> {
     return this.getProperty<string>('overflow');
@@ -166,7 +166,7 @@ export interface Translations {
   msgFetchingData: string;
   /**
    * Provides properties to customize the message text used by Navigation List when there are no items.
-   * @deprecated Since 17.0.0. This option has been deprecate. We will no long have the message when no data.
+   * @deprecated Since 17.0.0. oj-navigation-list no long displays a message when there are no items.
    */
   msgNoData: string;
   /**

package/{elements → src/elements}/oj-paging-control/OjPagingControl.ts

@@ -15,11 +15,12 @@ export class OjPagingControl extends OjPagingControlBase {
    */
   async changeSelection(page: number) {
     await this.whenReady();
-    await this.getDriver().executeAsyncScript(
-      'arguments[0].page(' + page + ').then(arguments[1])',
-      this
+    await this.getDriver().executeScript(
+      (element: any, page: number) => element.page(page),
+      this,
+      page
     );
     // Wait for animations to end
-    await this.whenBusyContextReady();
+    return this.whenBusyContextReady();
   }
 }

package/{elements → src/elements}/oj-paging-control/OjPagingControlBase.ts

@@ -21,7 +21,7 @@ export class OjPagingControlBase extends OjWebElement {
    * Gets the value of <code>loadMoreOptions</code> property.
    * Options for loadMore mode.
    * @return The value of <code>loadMoreOptions</code> property.
-   * @deprecated Since 7.0.0. This option is deprecated and will not get feature updates or support going forward. Please use native component high-water mark scrolling API instead (see Table, ListView, DataGrid). In addition, "loadMore" is not compatible with Table, Listview, DataGrid default scroll-policy "loadMoreOnScroll".
+   * @deprecated Since 7.0.0. Support for "loadMore" paging mode is deprecated. Use native component high-water mark scrolling APIs instead (see Table, ListView, and DataGrid for details). In addition, "loadMore" is not compatible with the Table, Listview, and DataGrid default scroll-policy "loadMoreOnScroll".
    */
   public getLoadMoreOptions(): Promise<LoadMoreOptions> {
     return this.getProperty<LoadMoreOptions>('loadMoreOptions');
@@ -80,7 +80,7 @@ export class OjPagingControlBase extends OjWebElement {
 export interface LoadMoreOptions {
   /**
    * The maximum number of items to display.
-   * @deprecated Since 7.0.0. This option is deprecated and will not get feature updates or support going forward. Please use native component high-water mark scrolling API instead (see Table, ListView, DataGrid).
+   * @deprecated Since 7.0.0. Support for "loadMore" paging mode is deprecated. Use native component high-water mark scrolling APIs instead (see Table, ListView, and DataGrid for details).
    */
   maxCount: number;
 }
@@ -157,12 +157,12 @@ export interface Translations {
   labelAccPaging: string;
   /**
    * Load more link text.
-   * @deprecated Since 7.0.0. This option is deprecated and will not get feature updates or support going forward. Please use native component high-water mark scrolling API instead (see Table, ListView, DataGrid).
+   * @deprecated Since 7.0.0. Support for "loadMore" paging mode is deprecated. Use native component high-water mark scrolling APIs instead (see Table, ListView, and DataGrid for details).
    */
   labelLoadMore: string;
   /**
    * Label for when load more has reached the maximum limit of rows to fetch.
-   * @deprecated Since 7.0.0. This option is deprecated and will not get feature updates or support going forward. Please use native component high-water mark scrolling API instead (see Table, ListView, DataGrid).
+   * @deprecated Since 7.0.0. Support for "loadMore" paging mode is deprecated. Use native component high-water mark scrolling APIs instead (see Table, ListView, and DataGrid for details).
    */
   labelLoadMoreMaxRows: string;
   /**

package/src/elements/oj-popup/OjPopup.ts

@@ -0,0 +1,20 @@
+import { OjPopupBase } from './OjPopupBase';
+
+/**
+ * The component WebElement for [oj-popup](../../jsdocs/oj.ojPopup.html).
+ * Do not instantiate this class directly, instead, use
+ * [ojPopup](../functions/elements.ojPopup-1.html).
+ */
+
+/**
+ * The component WebElement for [oj-popup](../../jsdocs/oj.ojPopup.html).
+ * Do not instantiate this class directly, instead, use
+ * [ojPopup](../functions/elements.ojPopup-1.html).
+ *  <h4>Migration</h4>
+ *  When you migrate a page from using [oj-popup](../../jsdocs/oj.ojPopup.html) to [oj-c-popup](../../jsdocs/oj-c.Popup.html) you will also need to migrate your WebDriver tests from OjPopup to PopupWebElement. To do that you will need to revise type and locator instances as follows
+ *  </br><b>Type:</b> from OjPopup to [PopupWebElement](../../cpwdtsdoc/classes/PopupWebElement.html)
+ *  </br><b>Locator:</b> from [ojPopup](../functions/elements.ojPopup-1.html) to [findPopup](../../cpwdtsdoc/functions/findPopup.html)
+ *  </br>For more details on migrating from legacy to core pack please see component's [migration section](../../jsdocs/oj.ojPopup.html#migration-section)
+ */
+
+export class OjPopup extends OjPopupBase {}

package/{elements → src/elements}/oj-radioset/OjRadioset.ts

@@ -58,12 +58,8 @@ export class OjRadioset extends OjRadiosetBase {
    */
   private async getRadio(value: any): Promise<WebElement | null> {
     const subId = { subId: 'oj-radioset-radio', value: value };
-    return await this.getDriver().executeScript<WebElement | null>(
-      `
-      var element = arguments[0];
-      var subId = arguments[1];
-      return element.getNodeBySubId(subId);
-    `,
+    return this.getDriver().executeScript<WebElement | null>(
+      (element: any, subId: string) => element.getNodeBySubId(subId),
       this,
       subId
     );

package/{elements → src/elements}/oj-radioset/OjRadiosetBase.ts

@@ -275,6 +275,7 @@ export interface Translations {
 export interface TranslationsRequired {
   /**
    * Hint text used by required validation error.
+   * @deprecated Since 18.0.0. Setting a required validator hint is not recommended in the Redwood design system.
    */
   hint: string;
   /**
@@ -283,7 +284,7 @@ export interface TranslationsRequired {
   messageDetail: string;
   /**
    * Message text for summarizing a required validation error.
-   * @deprecated Since 14.0.0. This is deprecated because in the Redwood design system form components do not show validator summaries, so this is no longer needed.
+   * @deprecated Since 14.0.0. In the Redwood design system form components do not show validator summaries, so this is no longer needed.
    */
   messageSummary: string;
 }

package/src/elements/oj-range-slider/OjRangeSlider.ts

@@ -0,0 +1,25 @@
+import { OjRangeSliderBase, Value } from './OjRangeSliderBase';
+
+/**
+ * The component WebElement for [oj-range-slider](../../jsdocs/oj.ojRangeSlider.html).
+ * Do not instantiate this class directly, instead, use
+ * [ojRangeSlider](../functions/elements.ojRangeSlider-1.html).
+ */
+export class OjRangeSlider extends OjRangeSliderBase {
+  // Put overrides here
+
+  /**
+   * Sets the value of the <code>value</code> property.
+   * The numerical value of the range-slider.
+   * @param value The value to set for <code>value</code>
+   */
+  async changeValue(value: Value | null) {
+    // Only mutate if not disabled
+    const disabled = await this.getDisabled();
+    if (!disabled) {
+      // Call focus() on the root element
+      await this.getDriver().executeScript((el: HTMLElement) => el.focus(), this);
+      return this.setProperty<Value | null>('value', value);
+    }
+  }
+}

package/{elements/oj-color-palette/OjColorPaletteBase.ts → src/elements/oj-range-slider/OjRangeSliderBase.ts}

@@ -1,12 +1,12 @@
 import { OjWebElement } from '../';
 
 /**
- * This is the base class for oj-color-palette WebElement, and is generated from the
+ * This is the base class for oj-range-slider WebElement, and is generated from the
  * component's metadata. Do not modify these contents since they'll be replaced
  * during the next generation.
- * Put overrides into the WebElements's subclass, OjColorPalette.ts.
+ * Put overrides into the WebElements's subclass, OjRangeSlider.ts.
  */
-export class OjColorPaletteBase extends OjWebElement {
+export class OjRangeSliderBase extends OjWebElement {
   /**
    * Gets the value of <code>describedBy</code> property.
    * The form component's oj-label automatically sets described-by to make it accessible. It is not meant to be set by application developer.
@@ -57,16 +57,6 @@ export class OjColorPaletteBase extends OjWebElement {
     return this.getProperty<HelpHints>('helpHints');
   }
 
-  /**
-   * Gets the value of <code>labelDisplay</code> property.
-   * Specifies whether a text label accompanies the color swatch.
-   * @return The value of <code>labelDisplay</code> property.
-   *
-   */
-  public getLabelDisplay(): Promise<string> {
-    return this.getProperty<string>('labelDisplay');
-  }
-
   /**
    * Gets the value of <code>labelEdge</code> property.
    * Defines how the label of a component is created. See the Help documentation for more information.
@@ -89,22 +79,22 @@ export class OjColorPaletteBase extends OjWebElement {
 
   /**
    * Gets the value of <code>labelledBy</code> property.
-   * Used to establish a relationship between this element and another element.
+   * The oj-label sets the labelledBy property programmatically on the form component.
    * @return The value of <code>labelledBy</code> property.
    *
    */
-  public getLabelledBy(): Promise<string> {
-    return this.getProperty<string>('labelledBy');
+  public getLabelledBy(): Promise<string | null> {
+    return this.getProperty<string | null>('labelledBy');
   }
 
   /**
-   * Gets the value of <code>layout</code> property.
-   * Specifies the layout of the color swatches.
-   * @return The value of <code>layout</code> property.
+   * Gets the value of <code>max</code> property.
+   * The maximum value of the range slider. See the Help documentation for more information.
+   * @return The value of <code>max</code> property.
    *
    */
-  public getLayout(): Promise<string> {
-    return this.getProperty<string>('layout');
+  public getMax(): Promise<number> {
+    return this.getProperty<number>('max');
   }
 
   /**
@@ -128,23 +118,43 @@ export class OjColorPaletteBase extends OjWebElement {
   }
 
   /**
-   * Gets the value of <code>palette</code> property.
-   * Specifies an array of objects defining the palette's color set.
-   * @return The value of <code>palette</code> property.
+   * Gets the value of <code>min</code> property.
+   * The minimum value of the range slider. See the Help documentation for more information.
+   * @return The value of <code>min</code> property.
+   *
+   */
+  public getMin(): Promise<number> {
+    return this.getProperty<number>('min');
+  }
+
+  /**
+   * Gets the value of <code>orientation</code> property.
+   * Specifies the orientation of the range slider.
+   * @return The value of <code>orientation</code> property.
+   *
+   */
+  public getOrientation(): Promise<string> {
+    return this.getProperty<string>('orientation');
+  }
+
+  /**
+   * Gets the value of <code>step</code> property.
+   * Specifies the amount to increase or decrease the value when moving in step increments. See the Help documentation for more information.
+   * @return The value of <code>step</code> property.
    *
    */
-  public getPalette(): Promise<Array<Palette>> {
-    return this.getProperty<Array<Palette>>('palette');
+  public getStep(): Promise<number> {
+    return this.getProperty<number>('step');
   }
 
   /**
-   * Gets the value of <code>swatchSize</code> property.
-   * Specifies the swatch size.
-   * @return The value of <code>swatchSize</code> property.
+   * Gets the value of <code>transientValue</code> property.
+   * Read-only property used for retrieving the transient value from the component. See the Help documentation for more information.
+   * @return The value of <code>transientValue</code> property.
    *
    */
-  public getSwatchSize(): Promise<string> {
-    return this.getProperty<string>('swatchSize');
+  public getTransientValue(): Promise<TransientValue | null> {
+    return this.getProperty<TransientValue | null>('transientValue');
   }
 
   /**
@@ -179,22 +189,22 @@ export class OjColorPaletteBase extends OjWebElement {
 
   /**
    * Sets the value of <code>value</code> property.
-   * The current value of the palette element.
+   * The numerical value of the range-slider.
    * @param value The value to set for <code>value</code>
    *
    */
-  public changeValue(value: object | string): Promise<void> {
-    return this.setProperty<object | string>('value', value);
+  public changeValue(value: Value | null): Promise<void> {
+    return this.setProperty<Value | null>('value', value);
   }
 
   /**
    * Gets the value of <code>value</code> property.
-   * The current value of the palette element.
+   * The numerical value of the range-slider.
    * @return The value of <code>value</code> property.
    *
    */
-  public getValue(): Promise<object | string> {
-    return this.getProperty<object | string>('value');
+  public getValue(): Promise<Value | null> {
+    return this.getProperty<Value | null>('value');
   }
 }
 export interface DisplayOptions {
@@ -232,19 +242,37 @@ export interface HelpHints {
    */
   source: string;
 }
-export interface Palette {
+export interface TransientValue {
   /**
-   * the color definition
+   * Specifies the end transientValue of the range selected.
    */
-  color: object;
+  end: number | null;
   /**
-   * optional descriptive string (refer to attribute label-display). If omitted, label defaults to the color's hex string format.
+   * Specifies the start transientValue of the range selected.
    */
-  label: string;
+  start: number | null;
 }
 export interface Translations {
   /**
-   * Label for swatch with no color.
+   * aria-label value for higher value thumb
+   */
+  higherValueThumb: string;
+  /**
+   * aria-label value for lower value thumb
+   */
+  lowerValueThumb: string;
+  /**
+   * value.start is greater than value.end.
+   */
+  startEnd: string;
+}
+export interface Value {
+  /**
+   * Specifies the end value of the range selected.
+   */
+  end: number | null;
+  /**
+   * Specifies the start value of the range selected.
    */
-  labelNone: string;
+  start: number | null;
 }

package/src/elements/oj-range-slider/index.ts

@@ -0,0 +1,34 @@
+import { By } from 'selenium-webdriver';
+import { DriverLike, register } from '../../';
+import { OjRangeSlider } from './OjRangeSlider';
+export { OjRangeSlider };
+
+/**
+ * Retrieve an instance of [OjRangeSlider](../classes/elements.OjRangeSlider.html).
+ * @example
+ * ```javascript
+ * import { ojRangeSlider } from '@oracle/oraclejet-webdriver/elements';
+ * const el = await ojRangeSlider(driver, By.id('my-oj-range-slider'));
+ * ```
+ * @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 ojRangeSlider(driver: DriverLike, by: By): Promise<OjRangeSlider> {
+  const webEl = await driver.findElement(by);
+  // Check that the element is of type OjRangeSlider
+  if (!(webEl instanceof OjRangeSlider)) {
+    const tagName = await webEl.getTagName();
+    let supplemental = '';
+    if (webEl.constructor.name === 'OjRangeSlider') {
+      supplemental = 'You likely have multiple installations of this package.';
+    }
+    throw Error(
+      `ojRangeSlider(${by}) created ${webEl.constructor.name} for <${tagName}>, but expected ${OjRangeSlider.name}. ${supplemental}`
+    );
+  }
+  return webEl;
+}
+
+register('oj-range-slider', OjRangeSlider);

package/src/elements/oj-rating-gauge/OjRatingGauge.ts

@@ -0,0 +1,21 @@
+import { OjRatingGaugeBase } from './OjRatingGaugeBase';
+
+/**
+ * The component WebElement for [oj-rating-gauge](../../jsdocs/oj.ojRatingGauge.html).
+ * Do not instantiate this class directly, instead, use
+ * [ojRatingGauge](../functions/elements.ojRatingGauge-1.html).
+ */
+
+/**
+ * The component WebElement for [oj-rating-gauge](../../jsdocs/oj.ojRatingGauge.html).
+ * Do not instantiate this class directly, instead, use
+ * [ojRatingGauge](../functions/elements.ojRatingGauge-1.html).
+ *  <h4>Migration</h4>
+ *  When you migrate a page from using [oj-rating-guage](../../jsdocs/oj.ojRatingGauge.html) to [oj-c-rating-gauge](../../jsdocs/oj-c.RatingGauge.html) you will also need to migrate your WebDriver tests from OjRatingGauge to RatingGaugeWebElement. To do that you will need to revise type and locator instances as follows
+ *  </br><b>Type:</b> from OjRatingGauge to [RatingGaugeWebElement](../../cpwdtsdoc/classes/RatingGaugeWebElement.html)
+ *  </br><b>Locator:</b> from [ojRatingGauge](../functions/elements.ojRatingGauge-1.html) to [findRatingGauge](../../cpwdtsdoc/functions/findRatingGauge.html)
+ *  </br>For more details on migrating from legacy to core pack please see component's [migration section](../../jsdocs/oj.ojRatingGauge.html#migration-section)
+ */
+export class OjRatingGauge extends OjRatingGaugeBase {
+  // Put overrides here
+}