@oracle/oraclejet-webdriver 16.1.6 → 17.0.1

package/elements/oj-date-time-picker/OjDateTimePickerBase.js

@@ -22,7 +22,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>autofocus</code> property.
      * Specifies whether the component will get input focus when the page is loaded. See the Help documentation for more information.
      * @return The value of <code>autofocus</code> property.
-     *
+     * @deprecated Since 17.0.0. This is not recommended for accessibility reasons.
      */
     getAutofocus() {
         return this.getProperty('autofocus');
@@ -58,7 +58,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>dayMetaData</code> property.
      * Specifies additional information to be used when rendering the day. See the Help documentation for more information.
      * @return The value of <code>dayMetaData</code> property.
-     *
+     * @deprecated Since 17.0.0. Use dayFormatter instead, as it is more flexible.
      */
     getDayMetaData() {
         return this.getProperty('dayMetaData');
@@ -67,7 +67,7 @@ class OjDateTimePickerBase extends __1.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.
      * @return The value of <code>describedBy</code> property.
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     getDescribedBy() {
         return this.getProperty('describedBy');
@@ -76,7 +76,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>disabled</code> property.
      * Specifies whether the component is disabled. The default is false.
      * @return The value of <code>disabled</code> property.
-     *
+     * @deprecated Since 17.0.0. Disabled is not supported by the Date Picker UX specification, use readonly property instead.
      */
     getDisabled() {
         return this.getProperty('disabled');
@@ -94,7 +94,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>help</code> property.
      * Form component help information.
      * @return The value of <code>help</code> property.
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     getHelp() {
         return this.getProperty('help');
@@ -103,7 +103,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>helpHints</code> property.
      * Represents hints for an oj-form-layout element to render help information on the label of the editable component.
      * @return The value of <code>helpHints</code> property.
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     getHelpHints() {
         return this.getProperty('helpHints');
@@ -112,7 +112,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>keyboardEdit</code> property.
      * Determines if keyboard entry of the text is allowed. When the datepicker is inline, the only supported value is "disabled".
      * @return The value of <code>keyboardEdit</code> property.
-     *
+     * @deprecated Since 17.0.0. This was never intended for the oj-date-time-picker component.
      */
     getKeyboardEdit() {
         return this.getProperty('keyboardEdit');
@@ -121,7 +121,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>labelEdge</code> property.
      * Defines how the label of a component is created. See the Help documentation for more information.
      * @return The value of <code>labelEdge</code> property.
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     getLabelEdge() {
         return this.getProperty('labelEdge');
@@ -130,7 +130,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>labelHint</code> property.
      * Represents a hint for oj-form-layout element to render a label on the editable component.
      * @return The value of <code>labelHint</code> property.
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     getLabelHint() {
         return this.getProperty('labelHint');
@@ -139,7 +139,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>labelledBy</code> property.
      * The oj-label sets the labelledBy property programmatically on the form component. See the Help documentation for more information.
      * @return The value of <code>labelledBy</code> property.
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     getLabelledBy() {
         return this.getProperty('labelledBy');
@@ -157,7 +157,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Sets the value of <code>messagesCustom</code> property.
      * A list of messages added by an application to the component. See the Help documentation for more information.
      * @param messagesCustom The value to set for <code>messagesCustom</code>
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     changeMessagesCustom(messagesCustom) {
         return this.setProperty('messagesCustom', messagesCustom);
@@ -166,7 +166,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>messagesCustom</code> property.
      * A list of messages added by an application to the component. See the Help documentation for more information.
      * @return The value of <code>messagesCustom</code> property.
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     getMessagesCustom() {
         return this.getProperty('messagesCustom');
@@ -202,7 +202,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>placeholder</code> property.
      * The placeholder text to set on the element.
      * @return The value of <code>placeholder</code> property.
-     *
+     * @deprecated Since 17.0.0. oj-date-time-picker doesn't have a text input, so this was never needed.
      */
     getPlaceholder() {
         return this.getProperty('placeholder');
@@ -238,7 +238,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>required</code> property.
      * Specifies whether the component is required or optional. See the Help documentation for more information.
      * @return The value of <code>required</code> property.
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     getRequired() {
         return this.getProperty('required');
@@ -265,7 +265,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
      * Gets the value of <code>userAssistanceDensity</code> property.
      * Specifies the density of the form component's user assistance presentation.
      * @return The value of <code>userAssistanceDensity</code> property.
-     *
+     * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
      */
     getUserAssistanceDensity() {
         return this.getProperty('userAssistanceDensity');
@@ -281,7 +281,7 @@ class OjDateTimePickerBase extends __1.OjWebElement {
     }
     /**
      * Gets the value of <code>validators</code> property.
-     * A list of validators used by the element, along with any implicit component validators, when performing validation. See the Help documentation for more information.
+     * Specifies a list of synchronous validators for performing validation by the element. See the Help documentation for more information.
      * @return The value of <code>validators</code> property.
      *
      */

package/elements/oj-date-time-picker/OjDateTimePickerBase.ts

@@ -21,7 +21,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>autofocus</code> property.
    * Specifies whether the component will get input focus when the page is loaded. See the Help documentation for more information.
    * @return The value of <code>autofocus</code> property.
-   *
+   * @deprecated Since 17.0.0. This is not recommended for accessibility reasons.
    */
   public getAutofocus(): Promise<boolean> {
     return this.getProperty<boolean>('autofocus');
@@ -61,7 +61,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>dayMetaData</code> property.
    * Specifies additional information to be used when rendering the day. See the Help documentation for more information.
    * @return The value of <code>dayMetaData</code> property.
-   *
+   * @deprecated Since 17.0.0. Use dayFormatter instead, as it is more flexible.
    */
   public getDayMetaData(): Promise<object> {
     return this.getProperty<object>('dayMetaData');
@@ -71,7 +71,7 @@ export class OjDateTimePickerBase 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.
    * @return The value of <code>describedBy</code> property.
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public getDescribedBy(): Promise<string> {
     return this.getProperty<string>('describedBy');
@@ -81,7 +81,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>disabled</code> property.
    * Specifies whether the component is disabled. The default is false.
    * @return The value of <code>disabled</code> property.
-   *
+   * @deprecated Since 17.0.0. Disabled is not supported by the Date Picker UX specification, use readonly property instead.
    */
   public getDisabled(): Promise<boolean> {
     return this.getProperty<boolean>('disabled');
@@ -101,7 +101,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>help</code> property.
    * Form component help information.
    * @return The value of <code>help</code> property.
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public getHelp(): Promise<Help> {
     return this.getProperty<Help>('help');
@@ -111,7 +111,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>helpHints</code> property.
    * Represents hints for an oj-form-layout element to render help information on the label of the editable component.
    * @return The value of <code>helpHints</code> property.
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public getHelpHints(): Promise<HelpHints> {
     return this.getProperty<HelpHints>('helpHints');
@@ -121,7 +121,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>keyboardEdit</code> property.
    * Determines if keyboard entry of the text is allowed. When the datepicker is inline, the only supported value is "disabled".
    * @return The value of <code>keyboardEdit</code> property.
-   *
+   * @deprecated Since 17.0.0. This was never intended for the oj-date-time-picker component.
    */
   public getKeyboardEdit(): Promise<string> {
     return this.getProperty<string>('keyboardEdit');
@@ -131,7 +131,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>labelEdge</code> property.
    * Defines how the label of a component is created. See the Help documentation for more information.
    * @return The value of <code>labelEdge</code> property.
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public getLabelEdge(): Promise<string> {
     return this.getProperty<string>('labelEdge');
@@ -141,7 +141,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>labelHint</code> property.
    * Represents a hint for oj-form-layout element to render a label on the editable component.
    * @return The value of <code>labelHint</code> property.
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public getLabelHint(): Promise<string> {
     return this.getProperty<string>('labelHint');
@@ -151,7 +151,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>labelledBy</code> property.
    * The oj-label sets the labelledBy property programmatically on the form component. See the Help documentation for more information.
    * @return The value of <code>labelledBy</code> property.
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public getLabelledBy(): Promise<string | null> {
     return this.getProperty<string | null>('labelledBy');
@@ -171,7 +171,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Sets the value of <code>messagesCustom</code> property.
    * A list of messages added by an application to the component. See the Help documentation for more information.
    * @param messagesCustom The value to set for <code>messagesCustom</code>
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public changeMessagesCustom(messagesCustom: Array<object>): Promise<void> {
     return this.setProperty<Array<object>>('messagesCustom', messagesCustom);
@@ -181,7 +181,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>messagesCustom</code> property.
    * A list of messages added by an application to the component. See the Help documentation for more information.
    * @return The value of <code>messagesCustom</code> property.
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public getMessagesCustom(): Promise<Array<object>> {
     return this.getProperty<Array<object>>('messagesCustom');
@@ -221,7 +221,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>placeholder</code> property.
    * The placeholder text to set on the element.
    * @return The value of <code>placeholder</code> property.
-   *
+   * @deprecated Since 17.0.0. oj-date-time-picker doesn't have a text input, so this was never needed.
    */
   public getPlaceholder(): Promise<string> {
     return this.getProperty<string>('placeholder');
@@ -261,7 +261,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>required</code> property.
    * Specifies whether the component is required or optional. See the Help documentation for more information.
    * @return The value of <code>required</code> property.
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public getRequired(): Promise<boolean> {
     return this.getProperty<boolean>('required');
@@ -291,7 +291,7 @@ export class OjDateTimePickerBase extends OjWebElement {
    * Gets the value of <code>userAssistanceDensity</code> property.
    * Specifies the density of the form component's user assistance presentation.
    * @return The value of <code>userAssistanceDensity</code> property.
-   *
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   public getUserAssistanceDensity(): Promise<string> {
     return this.getProperty<string>('userAssistanceDensity');
@@ -309,7 +309,7 @@ export class OjDateTimePickerBase extends OjWebElement {
 
   /**
    * Gets the value of <code>validators</code> property.
-   * A list of validators used by the element, along with any implicit component validators, when performing validation. See the Help documentation for more information.
+   * Specifies a list of synchronous validators for performing validation by the element. See the Help documentation for more information.
    * @return The value of <code>validators</code> property.
    *
    */
@@ -348,6 +348,7 @@ export interface DatePicker {
   changeYear: string;
   /**
    * Specifies the position in multiple months at which to show the current month (starting at 0).
+   * @deprecated Since 17.0.0. This is required when date-picker.number-of-months > 1, which is now deprecated, so this is no longer needed.
    */
   currentMonthPos: number;
   /**
@@ -361,18 +362,22 @@ export interface DatePicker {
   footerLayout: string;
   /**
    * Specifies the number of months to show at once. See the Help documentation for more information.
+   * @deprecated Since 17.0.0. This is not supported in the Redwood UX specification for Date Picker. See the Range Picker UX specification.
    */
   numberOfMonths: number;
   /**
    * Specifies when the date picker should be shown.
+   * @deprecated Since 17.0.0. This is not supported in the Redwood UX specification.
    */
   showOn: string;
   /**
    * Specifies the number of months to step backwards and forwards for the Ctrl+Alt+Page Up and Ctrl+Alt+Page Down keystrokes.
+   * @deprecated Since 17.0.0. This is not in the Redwood UX specification.
    */
   stepBigMonths: number;
   /**
    * Specifies how the prev and next keys will step backwards and forwards through the months. See the Help documentation for more information.
+   * @deprecated Since 17.0.0. This is not in the Redwood UX specification.
    */
   stepMonths: string | number;
   /**
@@ -381,6 +386,7 @@ export interface DatePicker {
   weekDisplay: string;
   /**
    * Specifies the range of years displayed in the year drop-down. See the Help documentation for more information.
+   * @deprecated Since 17.0.0. This is not in the Redwood UX specification. The 'min' and 'max' properties should be used instead.
    */
   yearRange: string;
 }
@@ -406,16 +412,19 @@ export interface DisplayOptions {
 export interface Help {
   /**
    * Represents advisory information for the component, such as would be appropriate for a tooltip.
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   instruction: string;
 }
 export interface HelpHints {
   /**
    * Hint for help definition text associated with the label.
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   definition: string;
   /**
    * Help source URL associated with the component.
+   * @deprecated Since 17.0.0. The oj-date-time-picker is used internally by the oj-input-date-time component and is not meant to display messages, be labelled, or be in a form layout by itself. Per the Redwood UX specification, the oj-date-time-picker is not intended to be a form component.
    */
   source: string;
 }
@@ -448,10 +457,12 @@ export interface TimePicker {
 export interface Translations {
   /**
    * Message to announce to AT via aria-live when the length.max is exceeded.
+   * @deprecated Since 17.0.0. This is not supported by the component.
    */
   accessibleMaxLengthExceeded: string;
   /**
    * Message to annnouce to AT via aria-live for the remaining character count.
+   * @deprecated Since 17.0.0. This is not supported by the component.
    */
   accessibleMaxLengthRemaining: string;
   /**
@@ -460,6 +471,7 @@ export interface Translations {
   cancel: string;
   /**
    * The text to display for the current day link.
+   * @deprecated Since 17.0.0. The Redwood UX specification does not allow this to be configurable.
    */
   currentText: string;
   /**
@@ -476,14 +488,17 @@ export interface Translations {
   done: string;
   /**
    * The text to display for the next month link.
+   * @deprecated Since 17.0.0. The Redwood UX specification does not allow this to be configurable.
    */
   nextText: string;
   /**
    * The text to display for the previous month link.
+   * @deprecated Since 17.0.0. The Redwood UX specification does not allow this to be configurable.
    */
   prevText: string;
   /**
    * Provides properties to customize the message text used by the implicit regexp validator associated to the InputText and TextArea components.
+   * @deprecated Since 17.0.0. This is not supported by the component.
    */
   regexp: TranslationsRegexp;
   /**
@@ -496,28 +511,34 @@ export interface Translations {
   time: string;
   /**
    * Tooltip text for the calendar icon.
+   * @deprecated Since 17.0.0. This is not configurable per component instance in the Redwood UX specification.
    */
   tooltipCalendar: string;
   /**
    * Tooltip text for the calendar icon when the component is disabled.
+   * @deprecated Since 17.0.0. This is not configurable per component instance in the Redwood UX specification.
    */
   tooltipCalendarDisabled: string;
   /**
    * Tooltip text for the calendar + time icon.
+   * @deprecated Since 17.0.0. This is not configurable per component instance in the Redwood UX specification.
    */
   tooltipCalendarTime: string;
   /**
    * Tooltip text for the calendar + time icon when the component is disabled.
+   * @deprecated Since 17.0.0. This is not configurable per component instance in the Redwood UX specification.
    */
   tooltipCalendarTimeDisabled: string;
   /**
    * The text to display for the week of the year column heading.
+   * @deprecated Since 17.0.0. The Redwood UX specification does not allow this to be configurable.
    */
   weekHeader: string;
 }
 export interface TranslationsDateRestriction {
   /**
    * Hint text used by the implicit date restriction validator associated to the InputDateTime and InputDate components.
+   * @deprecated Since 17.0.0. Please use help-hints instead.
    */
   hint: string;
   /**
@@ -526,12 +547,14 @@ export interface TranslationsDateRestriction {
   messageDetail: string;
   /**
    * Message summary for the implicit date restriction validator associated to the InputDateTime and InputDate components.
+   * @deprecated Since 17.0.0. This is not supported in the Redwood UX specification.
    */
   messageSummary: string;
 }
 export interface TranslationsDateTimeRange {
   /**
    * Provides properties to customize the hint text used by the implicit datetime range validator associated to the InputDateTime, InputDate, and InputTime components.
+   * @deprecated Since 17.0.0. Please use help-hints instead.
    */
   hint: TranslationsDateTimeRangeHint;
   /**
@@ -540,20 +563,24 @@ export interface TranslationsDateTimeRange {
   messageDetail: TranslationsDateTimeRangeMessageDetail;
   /**
    * Provides properties to customize the error message summary text used by the implicit datetime range validator associated to the InputDateTime, InputDate, and InputTime components.
+   * @deprecated Since 17.0.0. This is not supported in the Redwood UX specification.
    */
   messageSummary: TranslationsDateTimeRangeMessageSummary;
 }
 export interface TranslationsDateTimeRangeHint {
   /**
    * Hint text used by the implicit datetime range validator associated to the InputDateTime, InputDate, and InputTime components. hint.inRange is shown when both min and max are set, and is used to tell the user the allowed number range.
+   * @deprecated Since 17.0.0. Please use help-hints instead.
    */
   inRange: string;
   /**
    * Hint text used by the implicit datetime range validator associated to the InputDateTime, InputDate, and InputTime components. hint.max is shown when max is set and min is not set, and is used to tell the user the allowed maximum.
+   * @deprecated Since 17.0.0. Please use help-hints instead.
    */
   max: string;
   /**
    * Hint text used by the implicit datetime range validator associated to the InputDateTime, InputDate, and InputTime components. hint.min is shown when min is set and max is not set, and is used to tell the user the allowed minimum.
+   * @deprecated Since 17.0.0. Please use help-hints instead.
    */
   min: string;
 }
@@ -570,26 +597,31 @@ export interface TranslationsDateTimeRangeMessageDetail {
 export interface TranslationsDateTimeRangeMessageSummary {
   /**
    * Error message summary text used by the implicit datetime range validator associated to the InputDateTime, InputDate, and InputTime components. messageSummary.rangeOverflow is shown when max is set, and the value is greater than the maximum.
+   * @deprecated Since 17.0.0. This is not supported in the Redwood UX specification.
    */
   rangeOverflow: string;
   /**
    * Error message summary text used by the implicit datetime range validator associated to the InputDateTime, InputDate, and InputTime components. messageSummary.rangeUnderflow is shown when min is set, and the value is less than the minimum.
+   * @deprecated Since 17.0.0. This is not supported in the Redwood UX specification.
    */
   rangeUnderflow: string;
 }
 export interface TranslationsRegexp {
   /**
    * Provides properties to customize the error message detail used by the implicit regexp validator associated to the InputText and TextArea components.
+   * @deprecated Since 17.0.0. This is not supported by the component.
    */
   messageDetail: string;
   /**
    * Provides properties to customize the error message summary used by the implicit regexp validator associated to the InputText and TextArea components.
+   * @deprecated Since 17.0.0. This is not supported by the component.
    */
   messageSummary: string;
 }
 export interface TranslationsRequired {
   /**
    * Hint text used by required validation error.
+   * @deprecated Since 17.0.0. Please use help-hints instead.
    */
   hint: string;
   /**

package/elements/oj-diagram/OjDiagramBase.ts

@@ -672,18 +672,22 @@ export interface StyleDefaultsNodeDefaultsIcon {
   shape: string;
   /**
    * The URI of the node image
+   * @deprecated Since 17.0.0. Node source property has been deprecated. Please use custom renderer instead.
    */
   source: string;
   /**
    * The optional URI of the node hover image.
+   * @deprecated Since 17.0.0. Node sourceHover property has been deprecated. Please use custom renderer instead.
    */
   sourceHover: string;
   /**
    * The optional URI of the selected image on hover.
+   * @deprecated Since 17.0.0. Node sourceHoverSelected property has been deprecated. Please use custom renderer instead.
    */
   sourceHoverSelected: string;
   /**
    * The optional URI of the selected image.
+   * @deprecated Since 17.0.0. Node sourceSelected property has been deprecated. Please use custom renderer instead.
    */
   sourceSelected: string;
   /**

package/elements/oj-file-picker/OjFilePicker.js

@@ -4,6 +4,7 @@ exports.OjFilePicker = void 0;
 const OjFilePickerBase_1 = require("./OjFilePickerBase");
 const fs = require("fs");
 const path = require("path");
+const busy_context_utils_1 = require("../../lib/busy-context-utils");
 /**
  * The component WebElement for [oj-file-picker](../../jsdocs/oj.ojFilePicker.html).
  * Do not instantiate this class directly, instead, use
@@ -19,32 +20,97 @@ class OjFilePicker extends OjFilePickerBase_1.OjFilePickerBase {
      * @param files An array of objects containing the path and type of selected files
      */
     async doSelect(files) {
-        await this.whenReady();
-        let dataList;
-        dataList = [];
-        let file;
-        for (let i = 0; i < files.length; i++) {
-            const fileInfo = files[i];
-            const filePath = fileInfo.path;
-            const fileType = fileInfo.type;
-            const data = fs.readFileSync(filePath);
-            if (data) {
-                file = { bytes: Array.from(data), path: path.basename(filePath), type: fileType };
-                dataList.push(file);
+        await OjFilePicker.setupPickFiles(this.getDriver(), files);
+        await this.getDriver().executeScript(`arguments[0].firstChild.click();`, this);
+        await this.whenBusyContextReady();
+    }
+    /**
+     * This method should be called right before ojfilepickerutils.pickFiles
+     * Takes the webdriver and an Array of objects containing file paths + types.
+     * These files will be read from the local filesystem and then sent
+     * to the pickFiles method to simulate user file selection. Only the basename of
+     * the file will be sent, not the entire path to make it consistent with how
+     * the browser sets the value.
+     * @param driver the Webdriver of the test
+     * @param files An array of objects containing the path and type of selected files
+     */
+    static async setupPickFiles(driver, files) {
+        await (0, busy_context_utils_1.whenBusyContextReady)(driver);
+        //create a buffer with the files
+        const dataList = files.map(({ path: filePath, type }) => {
+            const fileSizeInMB = fs.statSync(filePath).size / (1024 * 1024);
+            const numberChunks = Math.ceil(fileSizeInMB / 8);
+            const fileContent = Array.from(fs.readFileSync(filePath));
+            const chunkSize = Math.floor(fileContent.length / numberChunks);
+            const fileChunks = [];
+            for (let i = 0; i < numberChunks; i++) {
+                if (i + 1 == numberChunks) {
+                    fileChunks.push(fileContent.slice(i * chunkSize));
+                }
+                else {
+                    fileChunks.push(fileContent.slice(i * chunkSize, (i + 1) * chunkSize));
+                }
+            }
+            return {
+                bytes: fileChunks, //split it into 8MB chunks
+                path: path.basename(filePath),
+                type,
+                numberChunks
+            };
+        });
+        for (let i = 0; i < dataList.length; i++) {
+            const { bytes, path, type, numberChunks } = dataList[i];
+            for (let j = 0; j < bytes.length; j++) {
+                const file = {
+                    bytes: bytes[j],
+                    path,
+                    type,
+                    numberChunks,
+                    chunkNumber: j,
+                    fileNumber: i
+                };
+                await driver.executeScript(`const file = arguments[0];
+           const chunkNumber = file.chunkNumber;
+           var data = {
+            bytes: file.bytes,
+            path: file.path,
+            type: file.type
+           }
+           if (chunkNumber == 0) {
+            window['_file' + file.fileNumber] = [data];
+           } else {
+            window['_file' + file.fileNumber].push(data);
+           }`, file);
             }
         }
-        await this.getDriver().executeAsyncScript([
-            'var fileList = [];',
-            'var list = arguments[1];',
-            'for(var i = 0; i < list.length; i++) {',
-            'var data = list[i];',
-            'fileList.push(new File([Uint8Array.from(data.bytes)], data.path, {type: data.type}));',
-            '}',
-            'fileList.item = function(i){return fileList[i];}',
-            //arguments[2] is a callback automatically passed in to continue executing the code
-            'arguments[0]._doSelectHelper(fileList).then(arguments[2]);'
-        ].join('\n'), this, dataList);
-        await this.whenBusyContextReady();
+        driver.executeScript(`const numFiles = arguments[0];
+      const list = [];
+      for ( let i = 0; i < numFiles; i++) {
+        const file = window['_file' + i];
+        delete window['_file' + i];
+        list.push({
+          bytes: file.map(chunk => chunk.bytes).join(''),
+          path: file[0].path,
+          type: file[0].type
+        });
+      }
+      const fileList = list.map((data) => {
+        return new File([Uint8Array.from(data.bytes)], data.path, {type: data.type});
+       })
+       // Only if setupPickFiles has not been called yet
+       if (!HTMLInputElement.prototype._pickerTestData) {
+        //Save the native click method
+        const clickMethod = HTMLInputElement.prototype.click;
+        //Overwrite the click method
+        HTMLInputElement.prototype.click = function() {
+          const event = new CustomEvent("change");
+          this.dispatchEvent(event);
+          delete HTMLInputElement.prototype._pickerTestData;
+          HTMLInputElement.prototype.click = clickMethod;
+        }
+       }
+       HTMLInputElement.prototype._pickerTestData = fileList;
+       `, dataList.length);
     }
 }
 exports.OjFilePicker = OjFilePicker;

package/elements/oj-file-picker/OjFilePicker.js.map

@@ -1 +1 @@
-{"version":3,"file":"OjFilePicker.js","sourceRoot":"","sources":["../../../elements/oj-file-picker/OjFilePicker.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AACtD,yBAAyB;AACzB,6BAA6B;AAC7B;;;;GAIG;AACH,MAAa,YAAa,SAAQ,mCAAgB;IAChD;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CAAC,KAA4C;QACzD,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,IAAI,QAAoB,CAAC;QACzB,QAAQ,GAAG,EAAE,CAAC;QACd,IAAI,IAAS,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC/B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAClF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,kBAAkB,CACvC;YACE,oBAAoB;YACpB,0BAA0B;YAC1B,wCAAwC;YACxC,qBAAqB;YACrB,uFAAuF;YACvF,GAAG;YACH,kDAAkD;YAClD,mFAAmF;YACnF,4DAA4D;SAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,IAAI,EACJ,QAAQ,CACT,CAAC;QACF,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC;CACF;AAzCD,oCAyCC"}
+{"version":3,"file":"OjFilePicker.js","sourceRoot":"","sources":["../../../elements/oj-file-picker/OjFilePicker.ts"],"names":[],"mappings":"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"}