@refinitiv-ui/elements 7.4.0 → 7.5.0

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [7.5.0](https://github.com/Refinitiv/refinitiv-ui/compare/@refinitiv-ui/elements@7.4.0...@refinitiv-ui/elements@7.5.0) (2023-09-18)
+
+### Bug Fixes
+
+- **slider:** incorrect updating `to` value ([#938](https://github.com/Refinitiv/refinitiv-ui/issues/938)) ([8479abc](https://github.com/Refinitiv/refinitiv-ui/commit/8479abc828571e06379b5f389058f60d5ba8443b))
+- **slider:** number field not revalidate when error state changes ([#942](https://github.com/Refinitiv/refinitiv-ui/issues/942)) ([5fc64a6](https://github.com/Refinitiv/refinitiv-ui/commit/5fc64a6ac21cdbbf820ae97de04ec19443755e50))
+
+### Features
+
+- **fields:** improve validation consistency for field elements ([#937](https://github.com/Refinitiv/refinitiv-ui/issues/937)) ([d58051c](https://github.com/Refinitiv/refinitiv-ui/commit/d58051c0b4d3508ac55d223299fd8bf267458ddf))
+- **utils:** add `selectedAt` property to `DataItem` interface ([4d69419](https://github.com/Refinitiv/refinitiv-ui/commit/4d69419107d8ed8dd554cb7cf0ecadd327d02f18))
+
 # [7.4.0](https://github.com/Refinitiv/refinitiv-ui/compare/@refinitiv-ui/elements@7.3.2...@refinitiv-ui/elements@7.4.0) (2023-09-11)
 
 ### Features

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright © 2023, Refinitiv.
+Copyright © 2023, LSEG
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

package/README.md

@@ -1,6 +1,6 @@
 # Element Framework
 
-Element Framework (EF) is a collection of elements that includes theming capability within the Refinitiv Workspace's design system. The elements are a set of web components which is a standard web technology and can be utilized across all browsers.
+Element Framework (EF) is a collection of elements that includes theming capability within the LSEG Workspace's design system. The elements are a set of web components which is a standard web technology and can be utilized across all browsers.
 
 ## Usage
 
@@ -10,17 +10,17 @@ EF elements are published under single package.
 npm install @refinitiv-ui/elements
 ```
 
-The elements are required theme to instantiate itself in the app. Refinitiv Workspace's design system is called Halo theme and you can install it from npm command.
+The elements are required theme to instantiate itself in the app. LSEG Workspace's design system is called Halo theme and you can install it from npm command.
 
 ```sh
 npm install @refinitiv-ui/halo-theme
 ```
 
-Finally, import both elements that you want to use and its themes into your application and it is ready to go. To follow Refinitiv Workspace's design system, it is required styles of some native elements e.g. typography.
+Finally, import both elements that you want to use and its themes into your application and it is ready to go. To follow LSEG Workspace's design system, it is required styles of some native elements e.g. typography.
 
 <br>
 
-> The font "Proxima Nova Fin" shall only be used within Refinitiv products or services. The copyright owner must approve any use of such font outside of Refinitiv products or services, which may be subject to a fee. Please see https://www.fontspring.com/lic/fontspring/webfont#license_text
+> The font "Proxima Nova Fin" shall only be used within LSEG products or services. The copyright owner must approve any use of such font outside of LSEG products or services, which may be subject to a fee. Please see https://www.fontspring.com/lic/fontspring/webfont#license_text
 
 <br>
 
@@ -57,4 +57,4 @@ See list of elements, demo and more tutorial by visiting [EF Documentation](http
 
 # License
 
-Apache License 2.0. However, Halo theme shall only be used within Refinitiv products or services due to license of the font "Proxima Nova Fin".
+Apache License 2.0. However, Halo theme shall only be used within LSEG products or services due to license of the font "Proxima Nova Fin".

package/lib/combo-box/index.js

@@ -288,9 +288,11 @@ let ComboBox = class ComboBox extends FormFieldElement {
      * @returns {void}
      */
     updateComposerValues(newValues) {
+        const selectedAt = Date.now();
         this.queryItems((item, composer) => {
             if (newValues.includes(composer.getItemPropertyValue(item, 'value'))) {
                 composer.setItemPropertyValue(item, 'selected', true);
+                composer.setItemPropertyValue(item, 'selectedAt', selectedAt + newValues.indexOf(item.value ?? '')); // Sequential selection
                 return true;
             }
             composer.setItemPropertyValue(item, 'selected', false);

package/lib/datetime-field/custom-elements.json

@@ -258,11 +258,6 @@
           "name": "checkValidity",
           "description": "Returns true if an input element contains valid data.",
           "params": []
-        },
-        {
-          "name": "reportValidity",
-          "description": "Validate input. Mark as error if input is invalid",
-          "params": []
         }
       ]
     }

package/lib/datetime-field/custom-elements.md

@@ -37,11 +37,10 @@ A form control element for datetime input.
 
 ## Methods
 
-| Method           | Type                             | Description                                      |
-|------------------|----------------------------------|--------------------------------------------------|
-| `checkValidity`  | `(): boolean`                    | Returns true if an input element contains valid data. |
-| `reportValidity` | `(): boolean`                    | Validate input. Mark as error if input is invalid |
-| `willUpdate`     | `(changedProperties: any): void` | Updates the element<br /><br />**changedProperties**: Properties that has changed |
+| Method          | Type                             | Description                                      |
+|-----------------|----------------------------------|--------------------------------------------------|
+| `checkValidity` | `(): boolean`                    | Returns true if an input element contains valid data. |
+| `willUpdate`    | `(changedProperties: any): void` | Updates the element<br /><br />**changedProperties**: Properties that has changed |
 
 ## Events
 

package/lib/datetime-field/index.d.ts

@@ -186,18 +186,6 @@ export declare class DatetimeField extends TextField {
      * @returns {void}
      */
     protected syncInputValue(changedProperties?: PropertyValues): void;
-    /**
-     * Check if input should be re-validated
-     * @param changedProperties Properties that has changed
-     * @returns True if input should be re-validated
-     */
-    protected shouldValidateInput(changedProperties: PropertyValues): boolean;
-    /**
-     * Validate input according `pattern`, `minLength` and `maxLength` properties
-     * change state of `error` property according pattern validation
-     * @returns {void}
-     */
-    protected validateInput(): void;
     /**
      * Override validation method for value
      * @param value value
@@ -244,21 +232,11 @@ export declare class DatetimeField extends TextField {
      * @returns {void}
      */
     protected setValueAndNotify(value: string): void;
-    /**
-     * Reset error state on input
-     * @returns {void}
-     */
-    protected resetError(): void;
     /**
      * Returns true if an input element contains valid data.
      * @returns true if input is valid
      */
     checkValidity(): boolean;
-    /**
-     * Validate input. Mark as error if input is invalid
-     * @returns false if there is an error
-     */
-    reportValidity(): boolean;
     /**
      * Select part
      * @param parts The list of parts

package/lib/datetime-field/index.js

@@ -294,23 +294,6 @@ let DatetimeField = class DatetimeField extends TextField {
             this.inputValue = inputValue; // setting the value resets selection
         }
     }
-    /**
-     * Check if input should be re-validated
-     * @param changedProperties Properties that has changed
-     * @returns True if input should be re-validated
-     */
-    shouldValidateInput(changedProperties) {
-        // TODO: this needs refactoring with all other fields to support common validation patterns
-        return changedProperties.has(FocusedPropertyKey) && !this.focused;
-    }
-    /**
-     * Validate input according `pattern`, `minLength` and `maxLength` properties
-     * change state of `error` property according pattern validation
-     * @returns {void}
-     */
-    validateInput() {
-        this.reportValidity();
-    }
     /**
      * Override validation method for value
      * @param value value
@@ -399,15 +382,6 @@ let DatetimeField = class DatetimeField extends TextField {
             this.notifyPropertyChange('value', value);
         }
     }
-    /**
-     * Reset error state on input
-     * @returns {void}
-     */
-    resetError() {
-        if (this.error && this.checkValidity()) {
-            this.reportValidity();
-        }
-    }
     /**
      * Returns true if an input element contains valid data.
      * @returns true if input is valid
@@ -433,15 +407,6 @@ let DatetimeField = class DatetimeField extends TextField {
         }
         return true;
     }
-    /**
-     * Validate input. Mark as error if input is invalid
-     * @returns false if there is an error
-     */
-    reportValidity() {
-        const hasError = !this.checkValidity();
-        this.notifyErrorChange(hasError);
-        return !hasError;
-    }
     /**
      * Select part
      * @param parts The list of parts
@@ -527,7 +492,7 @@ let DatetimeField = class DatetimeField extends TextField {
                     this.setValueAndNotify(newValue);
                     this.syncInputValue();
                     this.selectPart(this.formatToParts(newValue), selectedPartIndex);
-                    this.resetError();
+                    this.reportValidity();
                     event.preventDefault();
                 }
                 break;
@@ -547,8 +512,7 @@ let DatetimeField = class DatetimeField extends TextField {
      */
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     onPossibleValueChange(event) {
-        // Nobody likes to see a red border
-        this.resetError();
+        this.reportValidity();
         this.selectPartFrame.cancel(); // ensure no pending selection
         this.partLabel = '';
         const inputValue = this.inputElement?.value || '';

package/lib/email-field/index.d.ts

@@ -1,5 +1,4 @@
 import { JSXInterface } from '../jsx';
-import { PropertyValues } from '@refinitiv-ui/core';
 import { TemplateMap } from '@refinitiv-ui/core/directives/template-map.js';
 import '../icon/index.js';
 import { TextField } from '../text-field/index.js';
@@ -57,12 +56,6 @@ export declare class EmailField extends TextField {
      * @returns template map
      */
     protected get decorateInputMap(): TemplateMap;
-    /**
-     * Check if input should be re-validated
-     * @param changedProperties Properties that has changed
-     * @returns True if input should be re-validated
-     */
-    protected shouldValidateInput(changedProperties: PropertyValues): boolean;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/lib/email-field/index.js

@@ -52,7 +52,6 @@ let EmailField = class EmailField extends TextField {
          * Set to multiple mode, allows multiple emails in a single input
          */
         this.multiple = false;
-        /* c8 ignore stop */
     }
     /**
      * Decorate `<input>` element with common properties extended from text-field:
@@ -68,18 +67,6 @@ let EmailField = class EmailField extends TextField {
             multiple: this.multiple
         };
     }
-    /**
-     * Check if input should be re-validated
-     * @param changedProperties Properties that has changed
-     * @returns True if input should be re-validated
-     */
-    /* c8 ignore start */
-    shouldValidateInput(changedProperties) {
-        // TODO: This validation should be refactored
-        return (changedProperties.has('value') ||
-            changedProperties.has('multiple') ||
-            super.shouldValidateInput(changedProperties));
-    }
 };
 __decorate([
     property({ type: Boolean, reflect: true })

package/lib/number-field/custom-elements.json

@@ -196,11 +196,6 @@
           "name": "checkValidity",
           "description": "Returns true if an input element contains valid data.",
           "params": []
-        },
-        {
-          "name": "reportValidity",
-          "description": "Validate input. Mark as error if input is invalid",
-          "params": []
         }
       ]
     }

package/lib/number-field/custom-elements.md

@@ -21,12 +21,11 @@ Form control element for numbers.
 
 ## Methods
 
-| Method           | Type                                          | Description                                      |
-|------------------|-----------------------------------------------|--------------------------------------------------|
-| `checkValidity`  | `(): boolean`                                 | Returns true if an input element contains valid data. |
-| `reportValidity` | `(): boolean`                                 | Validate input. Mark as error if input is invalid |
-| `stepDown`       | `(stepIncrement?: number \| undefined): void` | Decreases the input value by amount of step<br /><br />**stepIncrement**: The stepIncrement parameter is a numeric value. If no parameter is passed, stepIncrement defaults to 1. |
-| `stepUp`         | `(stepIncrement?: number \| undefined): void` | Increases the input value by amount of step<br /><br />**stepIncrement**: The stepIncrement parameter is a numeric value. If no parameter is passed, stepIncrement defaults to 1. |
+| Method          | Type                                          | Description                                      |
+|-----------------|-----------------------------------------------|--------------------------------------------------|
+| `checkValidity` | `(): boolean`                                 | Returns true if an input element contains valid data. |
+| `stepDown`      | `(stepIncrement?: number \| undefined): void` | Decreases the input value by amount of step<br /><br />**stepIncrement**: The stepIncrement parameter is a numeric value. If no parameter is passed, stepIncrement defaults to 1. |
+| `stepUp`        | `(stepIncrement?: number \| undefined): void` | Increases the input value by amount of step<br /><br />**stepIncrement**: The stepIncrement parameter is a numeric value. If no parameter is passed, stepIncrement defaults to 1. |
 
 ## Events
 

package/lib/number-field/index.d.ts

@@ -209,11 +209,6 @@ export declare class NumberField extends FormFieldElement {
      * @returns {void}
      */
     private setSilentlyValueAndNotify;
-    /**
-     * Reset error state on input
-     * @returns {void}
-     */
-    private resetError;
     /**
      * Get the allowed step value
      * @returns allowed step
@@ -271,11 +266,6 @@ export declare class NumberField extends FormFieldElement {
      * @returns true if input is valid
      */
     checkValidity(): boolean;
-    /**
-     * Validate input. Mark as error if input is invalid
-     * @returns false if there is an error
-     */
-    reportValidity(): boolean;
     /**
      * @ignore
      * @inheritDoc

package/lib/number-field/index.js

@@ -138,8 +138,6 @@ let NumberField = class NumberField extends FormFieldElement {
      * @returns {void}
      */
     update(changedProperties) {
-        // This code probably should not be here, as validation must be instantiated by the app developer
-        // Keep the element inline with others for now
         if (changedProperties.has(FocusedPropertyKey) && !this.focused) {
             this.reportValidity();
         }
@@ -418,7 +416,7 @@ let NumberField = class NumberField extends FormFieldElement {
      */
     setSilentlyValueAndNotify() {
         // Nobody likes to see a red border
-        this.resetError();
+        this.reportValidity();
         const value = this.valueAsNumberString(this.inputValue);
         if (super.value !== value) {
             // here we must set the value silently to avoid re-rendering of input
@@ -426,15 +424,6 @@ let NumberField = class NumberField extends FormFieldElement {
             this.notifyPropertyChange('value', value);
         }
     }
-    /**
-     * Reset error state on input
-     * @returns {void}
-     */
-    resetError() {
-        if (this.error && this.checkValidity()) {
-            this.reportValidity();
-        }
-    }
     /**
      * Get the allowed step value
      * @returns allowed step
@@ -645,18 +634,6 @@ let NumberField = class NumberField extends FormFieldElement {
         }
         return true;
     }
-    /**
-     * Validate input. Mark as error if input is invalid
-     * @returns false if there is an error
-     */
-    reportValidity() {
-        const hasError = !this.checkValidity();
-        if (this.error !== hasError) {
-            this.error = hasError;
-            this.notifyPropertyChange('error', this.error);
-        }
-        return !hasError;
-    }
     /**
      * @ignore
      * @inheritDoc

package/lib/slider/custom-elements.json

@@ -177,7 +177,7 @@
         },
         {
           "name": "input",
-          "description": "Fired when the user inputs a value by interacting with the slider or updating its input field."
+          "description": "Fired with the value of the input in `e.detail.value` like another custom events when the user inputs a value by interacting with the slider or updating its input field."
         },
         {
           "name": "from-input",

package/lib/slider/custom-elements.md

@@ -25,7 +25,7 @@ Allows users to make selections from a range of values
 |-----------------|--------------------------------------------------|
 | `from-changed`  | Fired when the user changes from's value. The event is not triggered if `from` property is changed programmatically. |
 | `from-input`    | Fired when the user inputs from's value by interacting with the slider or updating its input field. |
-| `input`         | Fired when the user inputs a value by interacting with the slider or updating its input field. |
+| `input`         | Fired with the value of the input in `e.detail.value` like another custom events when the user inputs a value by interacting with the slider or updating its input field. |
 | `to-changed`    | Fired when the user changes to's value. The event is not triggered if `to` property is changed programmatically. |
 | `to-input`      | Fired when the user inputs to's value by interacting with the slider or updating its input field. |
 | `value-changed` | Fired when the user commits a value change. The event is not triggered if `value` property is changed programmatically. |

package/lib/slider/index.d.ts

@@ -18,7 +18,7 @@ import '../number-field/index.js';
  * @fires value-changed - Fired when the user commits a value change. The event is not triggered if `value` property is changed programmatically.
  * @fires from-changed - Fired when the user changes from's value. The event is not triggered if `from` property is changed programmatically.
  * @fires to-changed - Fired when the user changes to's value. The event is not triggered if `to` property is changed programmatically.
- * @fires input - Fired when the user inputs a value by interacting with the slider or updating its input field.
+ * @fires input - Fired with the value of the input in `e.detail.value` like another custom events when the user inputs a value by interacting with the slider or updating its input field.
  * @fires from-input - Fired when the user inputs from's value by interacting with the slider or updating its input field.
  * @fires to-input - Fired when the user inputs to's value by interacting with the slider or updating its input field.
  */
@@ -341,6 +341,11 @@ export declare class Slider extends ControlElement {
      * @returns validated to value.
      */
     private validateTo;
+    /**
+     * Validate number field from changed thumb
+     * @returns {void}
+     */
+    private validateNumberField;
     /**
      * Calculate the nearest possible step value depending on step interval
      * @param thumbPosition current thumb position in fraction

package/lib/slider/index.js

@@ -27,7 +27,7 @@ import { clamp, countDecimalPlace, isDecimalNumber, preventDefault } from './uti
  * @fires value-changed - Fired when the user commits a value change. The event is not triggered if `value` property is changed programmatically.
  * @fires from-changed - Fired when the user changes from's value. The event is not triggered if `from` property is changed programmatically.
  * @fires to-changed - Fired when the user changes to's value. The event is not triggered if `to` property is changed programmatically.
- * @fires input - Fired when the user inputs a value by interacting with the slider or updating its input field.
+ * @fires input - Fired with the value of the input in `e.detail.value` like another custom events when the user inputs a value by interacting with the slider or updating its input field.
  * @fires from-input - Fired when the user inputs from's value by interacting with the slider or updating its input field.
  * @fires to-input - Fired when the user inputs to's value by interacting with the slider or updating its input field.
  */
@@ -762,6 +762,7 @@ let Slider = class Slider extends ControlElement {
             this.valuePreviousInput = this.value;
         }
         this.onDrag(event);
+        this.validateNumberField();
         if (event.changedTouches) {
             this.addEventListener('touchmove', this.onDrag);
             this.addEventListener('touchend', this.onDragEnd);
@@ -855,6 +856,17 @@ let Slider = class Slider extends ControlElement {
         }
         return this.fromNumber + this.minRangeNumber;
     }
+    /**
+     * Validate number field from changed thumb
+     * @returns {void}
+     */
+    validateNumberField() {
+        if (this.isShowInputField) {
+            const name = this.changedThumb?.getAttribute('name');
+            const numberField = this[`${name}Input`];
+            requestAnimationFrame(() => numberField.reportValidity());
+        }
+    }
     /**
      * Calculate the nearest possible step value depending on step interval
      * @param thumbPosition current thumb position in fraction
@@ -996,7 +1008,7 @@ let Slider = class Slider extends ControlElement {
             if (valueFor === SliderDataName.to && value < this.fromNumber + this.minRangeNumber) {
                 return false;
             }
-            else if (value > this.toNumber - this.minRangeNumber) {
+            else if (valueFor === SliderDataName.from && value > this.toNumber - this.minRangeNumber) {
                 return false;
             }
         }

package/lib/text-field/index.d.ts

@@ -68,6 +68,12 @@ export declare class TextField extends FormFieldElement {
      * @returns {void}
      */
     protected firstUpdated(changedProperties: PropertyValues): void;
+    /**
+     * Updates the element
+     * @param changedProperties Properties that has changed
+     * @returns {void}
+     */
+    protected update(changedProperties: PropertyValues): void;
     /**
      * Called when the element’s DOM has been updated and rendered
      * @param changedProperties Properties that has changed
@@ -86,13 +92,7 @@ export declare class TextField extends FormFieldElement {
      * @param changedProperties Properties that has changed
      * @returns {void}
      */
-    protected syncInputValue(changedProperties: PropertyValues): void;
-    /**
-     * Check if input should be re-validated
-     * @param changedProperties Properties that has changed
-     * @returns True if input should be re-validated
-     */
-    protected shouldValidateInput(changedProperties: PropertyValues): boolean;
+    protected syncInputValue(): void;
     /**
      * Runs on input element `input` event
      * @param event `input` event
@@ -110,11 +110,6 @@ export declare class TextField extends FormFieldElement {
      * @returns {void}
      */
     protected onPossibleValueChange(event: InputEvent): void;
-    /**
-     * Uses native `checkValidity()` function to validate input
-     * @returns {void}
-     */
-    protected validateInput(): void;
     /**
      * Fires event on `icon` click
      * @returns {void}

package/lib/text-field/index.js

@@ -1,5 +1,5 @@
 import { __decorate } from "tslib";
-import { FormFieldElement, css, html, nothing } from '@refinitiv-ui/core';
+import { FocusedPropertyKey, FormFieldElement, css, html, nothing } from '@refinitiv-ui/core';
 import { customElement } from '@refinitiv-ui/core/decorators/custom-element.js';
 import { property } from '@refinitiv-ui/core/decorators/property.js';
 import { isElementOverflown } from '@refinitiv-ui/utils/element.js';
@@ -108,6 +108,17 @@ let TextField = class TextField extends FormFieldElement {
         super.firstUpdated(changedProperties);
         registerOverflowTooltip(this, () => this.inputValue, () => (this.inputElement ? isElementOverflown(this.inputElement) : false));
     }
+    /**
+     * Updates the element
+     * @param changedProperties Properties that has changed
+     * @returns {void}
+     */
+    update(changedProperties) {
+        if (changedProperties.has(FocusedPropertyKey) && !this.focused) {
+            this.reportValidity();
+        }
+        super.update(changedProperties);
+    }
     /**
      * Called when the element’s DOM has been updated and rendered
      * @param changedProperties Properties that has changed
@@ -116,10 +127,7 @@ let TextField = class TextField extends FormFieldElement {
     updated(changedProperties) {
         super.updated(changedProperties);
         if (this.shouldSyncInputValue(changedProperties)) {
-            this.syncInputValue(changedProperties);
-        }
-        if (this.shouldValidateInput(changedProperties)) {
-            this.validateInput();
+            this.syncInputValue();
         }
     }
     /**
@@ -137,26 +145,9 @@ let TextField = class TextField extends FormFieldElement {
      * @param changedProperties Properties that has changed
      * @returns {void}
      */
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    syncInputValue(changedProperties) {
+    syncInputValue() {
         this.inputValue = this.value;
     }
-    /**
-     * Check if input should be re-validated
-     * @param changedProperties Properties that has changed
-     * @returns True if input should be re-validated
-     */
-    /* c8 ignore start */
-    shouldValidateInput(changedProperties) {
-        // TODO: This validation should be refactored
-        return (changedProperties.has('pattern') ||
-            !!(this.pattern && changedProperties.has('value')) ||
-            changedProperties.has('minLength') ||
-            !!(this.minLength && changedProperties.has('value')) ||
-            changedProperties.has('maxLength') ||
-            !!(this.maxLength && changedProperties.has('value')));
-    }
-    /* c8 ignore stop */
     /**
      * Runs on input element `input` event
      * @param event `input` event
@@ -181,14 +172,7 @@ let TextField = class TextField extends FormFieldElement {
     onPossibleValueChange(event) {
         const value = this.inputElement?.value || '';
         this.setValueAndNotify(value);
-    }
-    /**
-     * Uses native `checkValidity()` function to validate input
-     * @returns {void}
-     */
-    validateInput() {
-        const error = !this.inputElement?.checkValidity();
-        this.notifyErrorChange(error);
+        this.reportValidity();
     }
     /**
      * Fires event on `icon` click

package/lib/tree/elements/tree.js

@@ -374,7 +374,7 @@ let Tree = class Tree extends List {
      */
     get values() {
         return this.manager.checkedItems.map((item) => {
-            return this.composer.getItemPropertyValue(item, 'value') || '';
+            return this.composer.getItemPropertyValue(item, 'value') ?? '';
         });
     }
     set values(values) {
@@ -384,9 +384,9 @@ let Tree = class Tree extends List {
         }
         else {
             // Clone value arrays
-            const newValue = [...values].sort().toString();
-            const oldValue = [...this.values].sort().toString();
-            if (newValue !== oldValue) {
+            const newValue = [...values];
+            const oldValue = [...this.values];
+            if (newValue.toString() !== oldValue.toString()) {
                 this.manager.uncheckAllItems();
                 values.some((value) => {
                     this.queryItemsByPropertyValue('value', value).forEach((item) => {

package/lib/tree/managers/tree-manager.d.ts

@@ -24,6 +24,10 @@ export declare class TreeManager<T extends TreeDataItem> {
      * Mode (algorithm) the tree manage is using
      */
     private mode;
+    /**
+     * Last selected item timestamp
+     */
+    private lastSelectedAt?;
     constructor(composer: CollectionComposer<T>, mode?: TreeManagerMode);
     /**
      * Is the manager maintaining parent/child relationships
@@ -42,6 +46,10 @@ export declare class TreeManager<T extends TreeDataItem> {
      * When managing relationships, this excludes groups/parents from the result.
      */
     get checkedItems(): readonly T[];
+    /**
+     * Compare items function order by sequential selected timestamp
+     */
+    protected get orderBySelectedAt(): (itemA: T, itemB: T) => number;
     /**
      * Items which should be visibly displayed.
      * This can be used to render items.

package/lib/tree/managers/tree-manager.js

@@ -47,12 +47,24 @@ export class TreeManager {
      * When managing relationships, this excludes groups/parents from the result.
      */
     get checkedItems() {
-        return this.composer.queryItems((item) => {
+        const items = this.composer.queryItems((item) => {
             if (this.manageRelationships && this.isItemParent(item)) {
                 return false;
             }
             return this.isItemChecked(item);
         }, Infinity);
+        return Object.freeze(items.slice().sort(this.orderBySelectedAt));
+    }
+    /**
+     * Compare items function order by sequential selected timestamp
+     */
+    get orderBySelectedAt() {
+        // Order by sequential selected timestamp
+        return (itemA, itemB) => {
+            const timeA = this.composer.getItemPropertyValue(itemA, 'selectedAt') ?? 0;
+            const timeB = this.composer.getItemPropertyValue(itemB, 'selectedAt') ?? 0;
+            return timeA - timeB;
+        };
     }
     /**
      * Items which should be visibly displayed.
@@ -341,7 +353,13 @@ export class TreeManager {
     }
     _checkItem(item, manageRelationships = this.manageRelationships) {
         if (this.canCheckItem(item)) {
+            // Create unique timestamp base on the latest selection for sequential selection.
+            const timestamp = Date.now();
+            this.lastSelectedAt =
+                this.lastSelectedAt && this.lastSelectedAt >= timestamp ? this.lastSelectedAt + 1 : timestamp;
+            // Set item selected with timestamp
             this.composer.setItemPropertyValue(item, 'selected', true);
+            this.composer.setItemPropertyValue(item, 'selectedAt', this.lastSelectedAt);
             if (manageRelationships) {
                 this.forceUpdateOnPath(item);
                 this.getItemDescendants(item).forEach((descendant) => this._checkItem(descendant, false));

package/lib/tree-select/index.d.ts

@@ -59,7 +59,11 @@ export declare class TreeSelect extends ComboBox<TreeSelectDataItem> {
     /**
      * Extracted values from {@link this.checkedGroupedItems}
      */
-    protected pillsData: TreeSelectDataItem[];
+    protected pillsData: Readonly<TreeSelectDataItem[]>;
+    /**
+     * Cache old selection timestamps for revert selected timestamps when cancel selection
+     */
+    protected oldSelection: Map<string, number | undefined>;
     /**
      * Are there pills visible
      */
@@ -207,10 +211,15 @@ export declare class TreeSelect extends ComboBox<TreeSelectDataItem> {
      */
     protected persistSelection(): void;
     /**
-     * Reverse selection. Run on Esc or Cancel
+     * Revert modified selection to old values. Run on Esc or Cancel
+     * @returns {void}
+     */
+    protected revertModifiedSelection(): void;
+    /**
+     * Revert all selected timestamps to the previous state which affect to item sorting
      * @returns {void}
      */
-    protected cancelSelection(): void;
+    protected revertSelectionTimestamps(): void;
     /**
      * Update memoized track
      *

package/lib/tree-select/index.js

@@ -1,5 +1,5 @@
 import { __decorate } from "tslib";
-import { css, html, nothing, triggerResize } from '@refinitiv-ui/core';
+import { WarningNotice, css, html, nothing, triggerResize } from '@refinitiv-ui/core';
 import { customElement } from '@refinitiv-ui/core/decorators/custom-element.js';
 import { property } from '@refinitiv-ui/core/decorators/property.js';
 import { query } from '@refinitiv-ui/core/decorators/query.js';
@@ -21,6 +21,7 @@ import { VERSION } from '../version.js';
 export { TreeSelectRenderer };
 const MEMO_THROTTLE = 16;
 const POPUP_POSITION = ['bottom-start', 'top-start'];
+const valueFormatWarning = new WarningNotice("The specified 'values' format does not conform to the required format.");
 /**
  * Dropdown control that allows selection from the tree list
  *
@@ -65,6 +66,10 @@ let TreeSelect = class TreeSelect extends ComboBox {
          * Extracted values from {@link this.checkedGroupedItems}
          */
         this.pillsData = [];
+        /**
+         * Cache old selection timestamps for revert selected timestamps when cancel selection
+         */
+        this.oldSelection = new Map();
         /**
          * Are there pills visible
          */
@@ -165,8 +170,26 @@ let TreeSelect = class TreeSelect extends ComboBox {
         return this._values;
     }
     set values(values) {
-        super.values = values;
-        this._values = values;
+        if (!Array.isArray(values)) {
+            valueFormatWarning.show();
+            this.values = [];
+            return;
+        }
+        // Update the selection state when found new value
+        const newValues = values.slice(0, this.multiple ? values.length : 1);
+        const oldValues = this.values.slice();
+        if (newValues.toString() !== oldValues.toString()) {
+            this._values = values;
+            this.updateComposerValues(values);
+            this.updatePills();
+            if (this.freeText) {
+                // free text mode is only supported in single selection mode
+                // so if there is no valid selection in the composer, we can assume
+                // the first item can be used as the free text item.
+                this.freeTextValue = !this.composerValues.length ? newValues[0] : '';
+            }
+            this.requestUpdate('values', oldValues);
+        }
     }
     /**
      * Set maximum number of selected items
@@ -228,7 +251,7 @@ let TreeSelect = class TreeSelect extends ComboBox {
      * @override
      */
     get selectedLabels() {
-        return this.checkedGroupedItems.map((selected) => this.getItemPropertyValue(selected, 'label') || '');
+        return this.checkedGroupedItems.map((selected) => this.getItemPropertyValue(selected, 'label') ?? '');
     }
     /**
      * Returns memoized selected state
@@ -332,29 +355,37 @@ let TreeSelect = class TreeSelect extends ComboBox {
      * @returns {void}
      */
     persistSelection() {
-        const oldValues = this.values.slice();
+        const oldValues = this.values;
         const newValues = this.composerValues;
-        const oldComparison = oldValues.sort().toString();
-        const newComparison = newValues.sort().toString();
-        if (oldComparison !== newComparison) {
+        if (oldValues.toString() !== newValues.toString()) {
+            // Set new values order by sequential selection
             this.values = newValues;
             this.notifyPropertyChange('value', this.value);
         }
     }
     /**
-     * Reverse selection. Run on Esc or Cancel
+     * Revert modified selection to old values. Run on Esc or Cancel
      * @returns {void}
      */
-    cancelSelection() {
-        const oldValues = this.values.slice();
+    revertModifiedSelection() {
+        const oldValues = this.values;
         const newValues = this.composerValues;
-        const oldComparison = oldValues.sort().toString();
-        const newComparison = newValues.sort().toString();
-        if (oldComparison !== newComparison) {
-            // revert selected item by updating the collection composer
-            this.updateComposerValues(this._values);
+        if (oldValues.toString() !== newValues.toString()) {
+            // Revert selected item by updating the collection composer
+            this.updateComposerValues(oldValues);
         }
     }
+    /**
+     * Revert all selected timestamps to the previous state which affect to item sorting
+     * @returns {void}
+     */
+    revertSelectionTimestamps() {
+        this.selection.forEach((item) => {
+            const oldSelectedAt = this.oldSelection.get(item.value);
+            this.composer.setItemPropertyValue(item, 'selectedAt', oldSelectedAt);
+        });
+        this.oldSelection.clear(); // Clear cache old selection
+    }
     /**
      * Update memoized track
      *
@@ -419,6 +450,7 @@ let TreeSelect = class TreeSelect extends ComboBox {
         const event = new CustomEvent('cancel');
         this.dispatchEvent(event);
         if (!event.defaultPrevented) {
+            this.revertSelectionTimestamps();
             this.closeAndReset();
             // reset always happens on popup close action
         }
@@ -487,6 +519,10 @@ let TreeSelect = class TreeSelect extends ComboBox {
     onPopupOpened() {
         super.onPopupOpened();
         this.clearSelectionFilter();
+        // Cache current selection timestamps for reverting modified selection when user cancel
+        this.selection.forEach((item) => {
+            this.oldSelection.set(item.value, this.getItemPropertyValue(item, 'selectedAt'));
+        });
         this.updatePills();
         this.updateMemo();
     }
@@ -504,7 +540,7 @@ let TreeSelect = class TreeSelect extends ComboBox {
     onPopupClosed() {
         super.onPopupClosed();
         this.updateMemo();
-        this.cancelSelection();
+        this.revertModifiedSelection();
         this.exitEditSelection();
     }
     /**
@@ -733,7 +769,7 @@ let TreeSelect = class TreeSelect extends ComboBox {
      */
     updatePills() {
         if (this.showPills) {
-            this.pillsData = this.checkedGroupedItems.slice();
+            this.pillsData = this.checkedGroupedItems;
             this.hasPills = !!this.pillsData.length;
         }
     }

package/lib/version.js

@@ -1 +1 @@
-export const VERSION = '7.4.0';
+export const VERSION = '7.5.0';

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@refinitiv-ui/elements",
-  "version": "7.4.0",
+  "version": "7.5.0",
   "description": "Element Framework Elements",
-  "author": "Refinitiv",
+  "author": "LSEG",
   "license": "Apache-2.0",
   "main": "./lib/index.js",
   "module": "./lib/index.js",
@@ -341,8 +341,8 @@
   },
   "dependencies": {
     "@lit-labs/context": "^0.3.1",
-    "@refinitiv-ui/halo-theme": "^7.1.0",
-    "@refinitiv-ui/solar-theme": "^7.1.0",
+    "@refinitiv-ui/halo-theme": "^7.1.1",
+    "@refinitiv-ui/solar-theme": "^7.1.1",
     "chart.js": "^4.3.0",
     "chartjs-adapter-date-fns": "^3.0.0",
     "d3-interpolate": "^3.0.1",
@@ -351,25 +351,25 @@
     "tslib": "^2.3.1"
   },
   "devDependencies": {
-    "@refinitiv-ui/core": "^7.1.0",
-    "@refinitiv-ui/demo-block": "^7.0.5",
-    "@refinitiv-ui/i18n": "^7.0.3",
-    "@refinitiv-ui/phrasebook": "^7.0.3",
-    "@refinitiv-ui/test-helpers": "^7.0.3",
-    "@refinitiv-ui/translate": "^7.0.3",
-    "@refinitiv-ui/utils": "^7.0.3",
+    "@refinitiv-ui/core": "^7.2.0",
+    "@refinitiv-ui/demo-block": "^7.0.6",
+    "@refinitiv-ui/i18n": "^7.0.4",
+    "@refinitiv-ui/phrasebook": "^7.0.4",
+    "@refinitiv-ui/test-helpers": "^7.0.4",
+    "@refinitiv-ui/translate": "^7.0.4",
+    "@refinitiv-ui/utils": "^7.1.0",
     "@types/d3-interpolate": "^3.0.1"
   },
   "peerDependencies": {
     "@refinitiv-ui/browser-sparkline": "^1.0.0 || ^2.0.0",
-    "@refinitiv-ui/core": "^7.1.0",
-    "@refinitiv-ui/i18n": "^7.0.3",
-    "@refinitiv-ui/phrasebook": "^7.0.3",
-    "@refinitiv-ui/translate": "^7.0.3",
-    "@refinitiv-ui/utils": "^7.0.3"
+    "@refinitiv-ui/core": "^7.2.0",
+    "@refinitiv-ui/i18n": "^7.0.4",
+    "@refinitiv-ui/phrasebook": "^7.0.4",
+    "@refinitiv-ui/translate": "^7.0.4",
+    "@refinitiv-ui/utils": "^7.1.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "d220dde5331f239eb4d3ca99ed4972ff3d290f9a"
+  "gitHead": "e162ec78601e5f97201d53d740925ee2075fd95e"
 }