@oracle/oraclejet-webdriver 20.1.2 → 21.0.0

package/bin/generate

@@ -37,6 +37,9 @@ const RESERVED_PROPS = {
 
 const PARAM_TYPE_REGEX = /([a-z]+)<(.+?>*)>/i;
 const PARAM_TYPE_ALL_REGEX = /([a-z]+)<(.+?>*)>/gi;
+const METADATA_NAME_REGEX = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+const TYPESCRIPT_IDENTIFIER_REGEX = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const VERSION_REGEX = /^[0-9A-Za-z][0-9A-Za-z.+-]*$/;
 
 let args = [...process.argv];
 // Read CLI args
@@ -91,6 +94,7 @@ if (!mdPath) {
 (async function () {
   const mdContents = await getMetadata(mdPath);
   const md = JSON.parse(mdContents);
+  validateMetadata(md);
   const packName = md.pack;
   const name = md.name;
   const fullName = packName ? `${packName}-${name}` : name;
@@ -116,13 +120,15 @@ if (!mdPath) {
   }
 
   // Package output dir is CCA's name
-  pkgDir += path.sep + name;
+  const outputRoot = path.resolve(pkgDir);
+  pkgDir = getSafeChildPath(outputRoot, name, 'component output directory');
   mkDirParents(pkgDir);
 
   // Create baseclass.ts content
   let content = [];
   let types = [];
   Object.keys(properties || {}).forEach((propName) => {
+    assertTypeScriptIdentifier(propName, 'metadata property name');
     const property = properties[propName];
     const typeDef = getTypeDefinition(propName, property);
     let type = typeDef.type;
@@ -226,20 +232,27 @@ function getDetailsFromType(typeValue) {
       let nestedTypes;
       const nested = types.match(PARAM_TYPE_ALL_REGEX);
       if (nested) {
-        nestedTypes = [getTypesInOrder(
-          types,
-          nested.map(getDetailsFromType).reduce((accum, t) => accum.concat(t), []),
-          ','
-        ).map(getTypeFromDetail).join(',')]
+        nestedTypes = [
+          getTypesInOrder(
+            types,
+            nested.map(getDetailsFromType).reduce((accum, t) => accum.concat(t), []),
+            ','
+          )
+            .map(getTypeFromDetail)
+            .join(',')
+        ];
       }
       return {
         type: generic,
-        params: nested ? nestedTypes : types
+        params: nested
+          ? nestedTypes
+          : types
               // remove parens around params "Array<(string|DvtTimeComponentScale)>"
               .replace(/[\(\)]/g, '')
               .split('|')
               // sanitized type params will use 'unknown' for unknown types
-              .map(getSanitizedType).map(t => t || 'unknown')
+              .map(getSanitizedType)
+              .map((t) => t || 'unknown')
               .filter(Boolean),
         original: pt
       };
@@ -317,7 +330,10 @@ function getSanitizedType(origType) {
   // handle multi-key types "string, string" used by generics
   const keys = origType.split(',').map((s) => s.trim());
   // Check against KNOWN_TYPES for mapped data type
-  return keys.map((k) => KNOWN_TYPES[k.toLowerCase()]).filter(Boolean).join(',');
+  return keys
+    .map((k) => KNOWN_TYPES[k.toLowerCase()])
+    .filter(Boolean)
+    .join(',');
 }
 
 /**
@@ -346,6 +362,7 @@ function getObjectType(name, type, props) {
     let nestedDecl = [];
     // Iterate through all property types and build their definitions
     Object.keys(typeProps).forEach((propName) => {
+      assertTypeScriptIdentifier(propName, 'metadata property name');
       const prop = typeProps[propName];
       const desc = getHTMLEscapedText(prop.description) || '';
       const types = getDetailsFromType(prop.type);
@@ -407,7 +424,11 @@ function getProperty(propName, obj) {
  * @return {string} The HTML-sanitized text
  */
 function getHTMLEscapedText(text) {
-  text = (text || '').replace(/</g, '&lt;');
+  text = (text || '')
+    .replace(/</g, '&lt;')
+    .replace(/\*\//g, '* /')
+    .replace(/\r\n?/g, '\n')
+    .replace(/\n/g, '\n * ');
   return text;
 }
 
@@ -550,7 +571,9 @@ function getDeprecation(property) {
   // Property getter deprecation can only apply when there's 1 status
   // and no target (applies to entire property)
   if (statuses && statuses.length === 1 && !status.target && status.type === 'deprecated') {
-    return `@deprecated Since ${status.since}. ${status.description}`;
+    return `@deprecated Since ${getHTMLEscapedText(status.since)}. ${getHTMLEscapedText(
+      status.description
+    )}`;
   }
   return '';
 }
@@ -584,6 +607,7 @@ function isMutable(property) {
  */
 function copy(templateName, dest, filters) {
   let contents = getTemplate(templateName, filters);
+  assertPathInside(pkgDir, dest, 'generated output file');
   fs.writeFileSync(dest, contents, { mode: 0o644 });
 }
 
@@ -601,19 +625,74 @@ function getTemplate(templateName, filters) {
     srcFile = path.join(defaultTemplates, templateName);
   }
   let contents = fs.readFileSync(srcFile, 'utf8');
-  Object.keys(filters || {}).forEach(function (key) {
-    // Use function to return 'val' to prevent values containing RegExp
-    // patterns like "$&" from repeating the key
-    function val() {
-      return filters[key];
-    }
-    while (contents.indexOf(key) > -1) {
-      contents = contents.replace(key, val);
-    }
-  });
+  const filterKeys = Object.keys(filters || {});
+  if (filterKeys.length) {
+    const tokenRegex = new RegExp(filterKeys.map(escapeRegExp).join('|'), 'g');
+    contents = contents.replace(tokenRegex, (token) => filters[token]);
+  }
   return contents;
 }
 
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function validateMetadata(md) {
+  assertMetadataName(md.name, 'metadata name');
+  if (md.pack !== undefined) {
+    assertMetadataName(md.pack, 'metadata pack name');
+  }
+  if (md.version !== undefined) {
+    assertSafeVersion(md.version);
+  }
+  validateProperties(md.properties, 'metadata properties');
+}
+
+function validateProperties(properties, label) {
+  Object.keys(properties || {}).forEach((propName) => {
+    assertTypeScriptIdentifier(propName, `${label}.${propName}`);
+    const property = properties[propName];
+    validateProperties(property && property.properties, `${label}.${propName}.properties`);
+    validateProperties(
+      getProperty('extension.vbdt.itemProperties', property),
+      `${label}.${propName}.extension.vbdt.itemProperties`
+    );
+  });
+}
+
+function assertMetadataName(name, label) {
+  if (typeof name !== 'string' || !METADATA_NAME_REGEX.test(name)) {
+    throw new Error(`${label} must be a lowercase dash-separated metadata name.`);
+  }
+}
+
+function assertSafeVersion(version) {
+  if (typeof version !== 'string' || !VERSION_REGEX.test(version)) {
+    throw new Error('metadata version contains unsupported characters.');
+  }
+}
+
+function assertTypeScriptIdentifier(identifier, label) {
+  if (typeof identifier !== 'string' || !TYPESCRIPT_IDENTIFIER_REGEX.test(identifier)) {
+    throw new Error(`${label} must be a valid TypeScript identifier.`);
+  }
+}
+
+function getSafeChildPath(parent, child, label) {
+  const dest = path.resolve(parent, child);
+  assertPathInside(parent, dest, label);
+  return dest;
+}
+
+function assertPathInside(parent, target, label) {
+  const parentPath = path.resolve(parent);
+  const targetPath = path.resolve(target);
+  const relative = path.relative(parentPath, targetPath);
+  if (relative === '' || relative.startsWith('..') || path.isAbsolute(relative)) {
+    throw new Error(`${label} must stay inside ${parentPath}.`);
+  }
+}
+
 /**
  * Get the metadata given the metadata path.  If the path is "-", read from stdin.
  * @param {string} mdPath The path to the metadata.  Can be a file path or stdin.

package/elements/oj-action-card/OjActionCard.d.ts

@@ -4,16 +4,6 @@ import { OjActionCardBase } from './OjActionCardBase';
  * Do not instantiate this class directly, instead, use
  * [ojActionCard](../functions/elements.ojActionCard-1.html).
  */
-/**
- * The component WebElement for [oj-action-card](../../jsdocs/oj.ojActionCard.html).
- * Do not instantiate this class directly, instead, use
- * [ojActionCard](../functions/elements.ojActionCard-1.html).
- *  <h4>Migration</h4>
- *  When you migrate a page from using [oj-action-card](../../jsdocs/oj.ojActionCard.html) to [oj-c-action-card](../../jsdocs/oj-c.ActionCard.html) you will also need to migrate your WebDriver tests from OjActionCard to ActionCardWebElement. To do that you will need to revise type and locator instances as follows
- *  </br><b>Type:</b> from OjActionCard to [ActionCardWebElement](../../cpwdtsdoc/classes/ActionCardWebElement.html)
- *  </br><b>Locator:</b> from [ojActionCard](../functions/elements.ojActionCard-1.html) to [findActionCard](../../cpwdtsdoc/functions/findActionCard.html)
- *  </br>For more details on migrating from legacy to core pack please see component's [migration section](../../jsdocs/oj.ojActionCard.html#migration-section)
- */
 export declare class OjActionCard extends OjActionCardBase {
     /**
      * Perform a click on the card

package/elements/oj-action-card/OjActionCard.js

@@ -7,16 +7,6 @@ const OjActionCardBase_1 = require("./OjActionCardBase");
  * Do not instantiate this class directly, instead, use
  * [ojActionCard](../functions/elements.ojActionCard-1.html).
  */
-/**
- * The component WebElement for [oj-action-card](../../jsdocs/oj.ojActionCard.html).
- * Do not instantiate this class directly, instead, use
- * [ojActionCard](../functions/elements.ojActionCard-1.html).
- *  <h4>Migration</h4>
- *  When you migrate a page from using [oj-action-card](../../jsdocs/oj.ojActionCard.html) to [oj-c-action-card](../../jsdocs/oj-c.ActionCard.html) you will also need to migrate your WebDriver tests from OjActionCard to ActionCardWebElement. To do that you will need to revise type and locator instances as follows
- *  </br><b>Type:</b> from OjActionCard to [ActionCardWebElement](../../cpwdtsdoc/classes/ActionCardWebElement.html)
- *  </br><b>Locator:</b> from [ojActionCard](../functions/elements.ojActionCard-1.html) to [findActionCard](../../cpwdtsdoc/functions/findActionCard.html)
- *  </br>For more details on migrating from legacy to core pack please see component's [migration section](../../jsdocs/oj.ojActionCard.html#migration-section)
- */
 class OjActionCard extends OjActionCardBase_1.OjActionCardBase {
     /**
      * Perform a click on the card

package/elements/oj-action-card/OjActionCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"OjActionCard.js","sourceRoot":"","sources":["../../src/elements/oj-action-card/OjActionCard.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAEtD;;;;GAIG;AAEH;;;;;;;;;GASG;AACH,MAAa,YAAa,SAAQ,mCAAgB;IAChD;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AAPD,oCAOC"}
+{"version":3,"file":"OjActionCard.js","sourceRoot":"","sources":["../../src/elements/oj-action-card/OjActionCard.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAEtD;;;;GAIG;AACH,MAAa,YAAa,SAAQ,mCAAgB;IAChD;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AAPD,oCAOC"}

package/elements/oj-diagram/OjDiagramBase.d.ts

@@ -411,6 +411,7 @@ export interface NodeContent {
 export interface Overview {
     /**
      * Specifies the region that will be scaled to fit within the overview.
+     * @deprecated Since 21.0.0. This property is deprecated. The component will choose a sensible fit area based on the diagram content.
      */
     fitArea: string;
     /**
@@ -419,10 +420,12 @@ export interface Overview {
     halign: string;
     /**
      * Overview window height.
+     * @deprecated Since 21.0.0. This property is deprecated. The component will choose a sensible overview height based on the diagram content.
      */
     height: number;
     /**
      * Controls how the fit area is scaled within the overview.
+     * @deprecated Since 21.0.0. This property is deprecated. The component will choose a sensible aspect ratio behavior based on the diagram content.
      */
     preserveAspectRatio: string;
     /**
@@ -435,6 +438,7 @@ export interface Overview {
     valign: string;
     /**
      * Overview window width.
+     * @deprecated Since 21.0.0. This property is deprecated. The component will choose a sensible overview width based on the diagram content.
      */
     width: number;
 }

package/elements/oj-list-view/OjListView.js

@@ -58,7 +58,7 @@ class OjListView extends OjListViewBase_1.OjListViewBase {
         let el = await this.getDriver().executeScript((ele, key) => ele.getNodeBySubId({ subId: 'oj-listview-item', key }), this, itemLocator.key);
         if (display === 'list') {
             if (el) {
-                el = el.findElement(selenium_webdriver_1.By.css('[role="gridcell"]'));
+                el = await el.findElement(selenium_webdriver_1.By.css('[role="gridcell"]'));
             }
             else {
                 throw new Error('The key specified is invalid or does not exist');

package/elements/oj-list-view/OjListView.js.map

@@ -1 +1 @@
-{"version":3,"file":"OjListView.js","sourceRoot":"","sources":["../../src/elements/oj-list-view/OjListView.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OjListView.js","sourceRoot":"","sources":["../../src/elements/oj-list-view/OjListView.ts"],"names":[],"mappings":"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"}

package/elements/oj-picto-chart/OjPictoChart.d.ts

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

package/elements/oj-picto-chart/OjPictoChart.js

@@ -7,6 +7,16 @@ const OjPictoChartBase_1 = require("./OjPictoChartBase");
  * Do not instantiate this class directly, instead, use
  * [ojPictoChart](../functions/elements.ojPictoChart-1.html).
  */
+/**
+ * The component WebElement for [oj-picto-chart](../../jsdocs/oj.ojPictoChart.html).
+ * Do not instantiate this class directly, instead, use
+ * [ojPictoChart](../functions/elements.ojPictoChart-1.html).
+ *  <h4>Migration</h4>
+ *  When you migrate a page from using [oj-picto-chart](../../jsdocs/oj.ojPictoChart.html) to [oj-c-picto-chart](../../jsdocs/oj-c.PictoChart.html) you will also need to migrate your WebDriver tests from OjPictoChart to PictoChartWebElement. To do that you will need to revise type and locator instances as follows
+ *  </br><b>Type:</b> from ojPictoChart to [PictoChartWebElement](../../cpwdtsdoc/classes/PictoChartWebElement.html)
+ *  </br><b>Locator:</b> from [ojPictoChart](../functions/elements.ojPictoChart-1.html) to [findPictoChart](../../cpwdtsdoc/functions/findPictoChart.html)
+ *  </br>For more details on migrating from legacy to core pack please see component's [migration section](../../jsdocs/oj.ojPictoChart.html#migration-section)
+ */
 class OjPictoChart extends OjPictoChartBase_1.OjPictoChartBase {
 }
 exports.OjPictoChart = OjPictoChart;

package/elements/oj-picto-chart/OjPictoChart.js.map

@@ -1 +1 @@
-{"version":3,"file":"OjPictoChart.js","sourceRoot":"","sources":["../../src/elements/oj-picto-chart/OjPictoChart.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAEtD;;;;GAIG;AACH,MAAa,YAAa,SAAQ,mCAAgB;CAEjD;AAFD,oCAEC"}
+{"version":3,"file":"OjPictoChart.js","sourceRoot":"","sources":["../../src/elements/oj-picto-chart/OjPictoChart.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAEtD;;;;GAIG;AACH;;;;;;;;;GASG;AACH,MAAa,YAAa,SAAQ,mCAAgB;CAEjD;AAFD,oCAEC"}

package/elements/oj-picto-chart/OjPictoChartBase.d.ts

@@ -101,7 +101,7 @@ export declare class OjPictoChartBase extends OjWebElement {
      * Gets the value of <code>hoverBehaviorDelay</code> property.
      * Specifies initial hover delay in milliseconds for highlighting data items.
      * @return The value of <code>hoverBehaviorDelay</code> property.
-     *
+     * @deprecated Since 21.0.0. This is not recommended in the Redwood design system.
      */
     getHoverBehaviorDelay(): Promise<number>;
     /**

package/elements/oj-picto-chart/OjPictoChartBase.js

@@ -130,7 +130,7 @@ class OjPictoChartBase extends __1.OjWebElement {
      * Gets the value of <code>hoverBehaviorDelay</code> property.
      * Specifies initial hover delay in milliseconds for highlighting data items.
      * @return The value of <code>hoverBehaviorDelay</code> property.
-     *
+     * @deprecated Since 21.0.0. This is not recommended in the Redwood design system.
      */
     getHoverBehaviorDelay() {
         return this.getProperty('hoverBehaviorDelay');

package/elements/oj-switch/OjSwitchBase.d.ts

@@ -164,10 +164,12 @@ export interface HelpHints {
 export interface Translations {
     /**
      * Text to be displayed when the oj-switch is in readonly mode and value is false.
+     * @deprecated Since 21.0.0. The Redwood UX specification does not allow this to be configurable.
      */
     switchOff: string;
     /**
      * Text to be displayed when the oj-switch is in readonly mode and value is true.
+     * @deprecated Since 21.0.0. The Redwood UX specification does not allow this to be configurable.
      */
     switchOn: string;
 }

package/elements/oj-train/OjTrainBase.d.ts

@@ -60,46 +60,57 @@ export interface Steps {
 export interface Translations {
     /**
      * Description for the current train step status.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepCurrent: string;
     /**
      * Description for the disabled train step status.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepDisabled: string;
     /**
      * General description for a train step. The text may contain tokens '{index}' and '{count}', which will be replaced by the corresponding train step values.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepInfo: string;
     /**
      * Description for the train step message type Confirmation.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepMessageConfirmation: string;
     /**
      * Description for the train step message type Error.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepMessageError: string;
     /**
      * Description for the train step message type Info.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepMessageInfo: string;
     /**
      * Description for the train step message type. The actual value is passed in the '{messageType}' token.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepMessageType: string;
     /**
      * Description for the train step message type Warning.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepMessageWarning: string;
     /**
      * Description for the non-visited train step status.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepNotVisited: string;
     /**
      * Description for the train step status. The actual status value is passed in the '{status}' token.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepStatus: string;
     /**
      * Description for the visited train step status.
+     * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
      */
     stepVisited: string;
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@oracle/oraclejet-webdriver",
   "description": "Oracle JET WebDriverJS WebElements",
   "config": {
-    "revision": "2026-06-01_10-24-08"
+    "revision": "2026-08-11_09-49-16"
   },
   "scripts": {
     "build": "turbo run-build --filter=@oracle/oraclejet-webdriver",
@@ -59,8 +59,8 @@
     "selenium-webdriver": ">=4.0.0"
   },
   "dependencies": {
-    "@oracle/oraclejet": "20.1.2",
-    "@oracle/oraclejet-selenium-driver": "20.1.2"
+    "@oracle/oraclejet": "21.0.0",
+    "@oracle/oraclejet-selenium-driver": "21.0.0"
   },
   "devDependencies": {
     "@jest/globals": "29.6.2",
@@ -83,5 +83,5 @@
     "typescript-eslint": "8.29.1",
     "typescript-parser": "^2.6.1"
   },
-  "version": "20.1.2"
+  "version": "21.0.0"
 }

package/src/elements/oj-action-card/OjActionCard.ts

@@ -5,17 +5,6 @@ import { OjActionCardBase } from './OjActionCardBase';
  * Do not instantiate this class directly, instead, use
  * [ojActionCard](../functions/elements.ojActionCard-1.html).
  */
-
-/**
- * The component WebElement for [oj-action-card](../../jsdocs/oj.ojActionCard.html).
- * Do not instantiate this class directly, instead, use
- * [ojActionCard](../functions/elements.ojActionCard-1.html).
- *  <h4>Migration</h4>
- *  When you migrate a page from using [oj-action-card](../../jsdocs/oj.ojActionCard.html) to [oj-c-action-card](../../jsdocs/oj-c.ActionCard.html) you will also need to migrate your WebDriver tests from OjActionCard to ActionCardWebElement. To do that you will need to revise type and locator instances as follows
- *  </br><b>Type:</b> from OjActionCard to [ActionCardWebElement](../../cpwdtsdoc/classes/ActionCardWebElement.html)
- *  </br><b>Locator:</b> from [ojActionCard](../functions/elements.ojActionCard-1.html) to [findActionCard](../../cpwdtsdoc/functions/findActionCard.html)
- *  </br>For more details on migrating from legacy to core pack please see component's [migration section](../../jsdocs/oj.ojActionCard.html#migration-section)
- */
 export class OjActionCard extends OjActionCardBase {
   /**
    * Perform a click on the card

package/src/elements/oj-diagram/OjDiagramBase.ts

@@ -534,6 +534,7 @@ export interface NodeContent {
 export interface Overview {
   /**
    * Specifies the region that will be scaled to fit within the overview.
+   * @deprecated Since 21.0.0. This property is deprecated. The component will choose a sensible fit area based on the diagram content.
    */
   fitArea: string;
   /**
@@ -542,10 +543,12 @@ export interface Overview {
   halign: string;
   /**
    * Overview window height.
+   * @deprecated Since 21.0.0. This property is deprecated. The component will choose a sensible overview height based on the diagram content.
    */
   height: number;
   /**
    * Controls how the fit area is scaled within the overview.
+   * @deprecated Since 21.0.0. This property is deprecated. The component will choose a sensible aspect ratio behavior based on the diagram content.
    */
   preserveAspectRatio: string;
   /**
@@ -558,6 +561,7 @@ export interface Overview {
   valign: string;
   /**
    * Overview window width.
+   * @deprecated Since 21.0.0. This property is deprecated. The component will choose a sensible overview width based on the diagram content.
    */
   width: number;
 }

package/src/elements/oj-list-view/OjListView.ts

@@ -67,7 +67,7 @@ export class OjListView extends OjListViewBase {
     );
     if (display === 'list') {
       if (el) {
-        el = el.findElement(By.css('[role="gridcell"]'));
+        el = await el.findElement(By.css('[role="gridcell"]'));
       } else {
         throw new Error('The key specified is invalid or does not exist');
       }

package/src/elements/oj-picto-chart/OjPictoChart.ts

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

package/src/elements/oj-picto-chart/OjPictoChartBase.ts

@@ -141,7 +141,7 @@ export class OjPictoChartBase extends OjWebElement {
    * Gets the value of <code>hoverBehaviorDelay</code> property.
    * Specifies initial hover delay in milliseconds for highlighting data items.
    * @return The value of <code>hoverBehaviorDelay</code> property.
-   *
+   * @deprecated Since 21.0.0. This is not recommended in the Redwood design system.
    */
   public getHoverBehaviorDelay(): Promise<number> {
     return this.getProperty<number>('hoverBehaviorDelay');

package/src/elements/oj-switch/OjSwitchBase.ts

@@ -215,10 +215,12 @@ export interface HelpHints {
 export interface Translations {
   /**
    * Text to be displayed when the oj-switch is in readonly mode and value is false.
+   * @deprecated Since 21.0.0. The Redwood UX specification does not allow this to be configurable.
    */
   switchOff: string;
   /**
    * Text to be displayed when the oj-switch is in readonly mode and value is true.
+   * @deprecated Since 21.0.0. The Redwood UX specification does not allow this to be configurable.
    */
   switchOn: string;
 }

package/src/elements/oj-train/OjTrainBase.ts

@@ -72,46 +72,57 @@ export interface Steps {
 export interface Translations {
   /**
    * Description for the current train step status.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepCurrent: string;
   /**
    * Description for the disabled train step status.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepDisabled: string;
   /**
    * General description for a train step. The text may contain tokens '{index}' and '{count}', which will be replaced by the corresponding train step values.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepInfo: string;
   /**
    * Description for the train step message type Confirmation.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepMessageConfirmation: string;
   /**
    * Description for the train step message type Error.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepMessageError: string;
   /**
    * Description for the train step message type Info.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepMessageInfo: string;
   /**
    * Description for the train step message type. The actual value is passed in the '{messageType}' token.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepMessageType: string;
   /**
    * Description for the train step message type Warning.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepMessageWarning: string;
   /**
    * Description for the non-visited train step status.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepNotVisited: string;
   /**
    * Description for the train step status. The actual status value is passed in the '{status}' token.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepStatus: string;
   /**
    * Description for the visited train step status.
+   * @deprecated Since 21.0.0. This property is deprecated and will be removed in a future release.
    */
   stepVisited: string;
 }

package/wdtsdoc/classes/elements.OjActionCard.html

@@ -1,11 +1,6 @@
 <!DOCTYPE html><html class="default" lang="en"><head><meta charSet="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>OjActionCard | @oracle/oraclejet-webdriver</title><meta name="description" content="Documentation for @oracle/oraclejet-webdriver"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os"</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><div class="table-cell" id="tsd-search" data-base=".."><div class="field"><label for="tsd-search-field" class="tsd-widget tsd-toolbar-icon search no-caption"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-search"></use></svg></label><input type="text" id="tsd-search-field" aria-label="Search"/></div><div class="field"><div id="tsd-toolbar-links"></div></div><ul class="results"><li class="state loading">Preparing search index...</li><li class="state failure">The search index is not available</li></ul><a href="../index.html" class="title">@oracle/oraclejet-webdriver</a></div><div class="table-cell" id="tsd-widgets"><a href="#" class="tsd-widget tsd-toolbar-icon menu no-caption" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-menu"></use></svg></a></div></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb"><li><a href="../index.html">@oracle/oraclejet-webdriver</a></li><li><a href="../modules/elements.html">elements</a></li><li><a href="elements.OjActionCard.html">OjActionCard</a></li></ul><h1>Class OjActionCard</h1></div><section class="tsd-panel tsd-comment"><div class="tsd-comment tsd-typography"><p>The component WebElement for <a href="../../jsdocs/oj.ojActionCard.html">oj-action-card</a>.
 Do not instantiate this class directly, instead, use
-<a href="../functions/elements.ojActionCard-1.html">ojActionCard</a>.
- <h4>Migration</h4>
- When you migrate a page from using <a href="../../jsdocs/oj.ojActionCard.html">oj-action-card</a> to <a href="../../jsdocs/oj-c.ActionCard.html">oj-c-action-card</a> you will also need to migrate your WebDriver tests from OjActionCard to ActionCardWebElement. To do that you will need to revise type and locator instances as follows
- </br><b>Type:</b> from OjActionCard to <a href="../../cpwdtsdoc/classes/ActionCardWebElement.html">ActionCardWebElement</a>
- </br><b>Locator:</b> from <a href="../functions/elements.ojActionCard-1.html">ojActionCard</a> to <a href="../../cpwdtsdoc/functions/findActionCard.html">findActionCard</a>
- </br>For more details on migrating from legacy to core pack please see component&#39;s <a href="../../jsdocs/oj.ojActionCard.html#migration-section">migration section</a></p>
+<a href="../functions/elements.ojActionCard-1.html">ojActionCard</a>.</p>
 </div><div class="tsd-comment tsd-typography"></div></section><section class="tsd-panel tsd-hierarchy"><h4>Hierarchy</h4><ul class="tsd-hierarchy"><li><a href="elements._internal_.OjActionCardBase.html" class="tsd-signature-type tsd-kind-class">OjActionCardBase</a><ul class="tsd-hierarchy"><li><span class="target">OjActionCard</span></li></ul></li></ul></section><section class="tsd-panel-group tsd-index-group"><section class="tsd-panel tsd-index-panel"><details class="tsd-index-content tsd-index-accordion" open><summary class="tsd-accordion-summary tsd-index-summary"><h5 class="tsd-index-heading uppercase" role="button" aria-expanded="false" tabIndex="0"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-chevronSmall"></use></svg> Index</h5></summary><div class="tsd-accordion-details"><section class="tsd-index-section"><h3 class="tsd-index-heading">Constructors</h3><div class="tsd-index-list"><a href="elements.OjActionCard.html#constructor" class="tsd-index-link tsd-is-inherited"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-512"></use></svg><span>constructor</span></a>
 </div></section><section class="tsd-index-section"><h3 class="tsd-index-heading">Methods</h3><div class="tsd-index-list"><a href="elements.OjActionCard.html#clear" class="tsd-index-link tsd-is-inherited"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2048"></use></svg><span>clear</span></a>
 <a href="elements.OjActionCard.html#click" class="tsd-index-link tsd-is-inherited"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2048"></use></svg><span>click</span></a>