@sankhyalabs/core 5.20.0-dev.2 → 5.20.0-dev.21

package/reports/test-report.xml

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<unitTest version="1">
+    <file path="/builds/dti/design-system/sankhyacore/test/http/SkwHttpProvider.ts.spec.ts">
+        <testCase name="HttpProvider Metodo POST" duration="4"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/http/HttpProvider.spec.ts">
+        <testCase name="HttpProvider Metodo GET" duration="80"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/MaskFormatter.spec.ts">
+        <testCase name="Mask Formatter mask:CPF complete valid" duration="80"/>
+        <testCase name="Mask Formatter mask:CPF complete valid literals" duration="8"/>
+        <testCase name="Mask Formatter mask:CPF incomplete valid" duration="1"/>
+        <testCase name="Mask Formatter mask:CPF incomplete valid placeholder" duration="1"/>
+        <testCase name="Mask Formatter mask:CPF too long valid" duration="1"/>
+        <testCase name="Mask Formatter mask:CPF invalid for string" duration="91"/>
+        <testCase name="Mask Formatter mask:CPF invalid for being too long" duration="1"/>
+        <testCase name="Mask Formatter mask:Licence plate valid uppercase" duration="0"/>
+        <testCase name="Mask Formatter mask:Licence plate valid lowercase" duration="1"/>
+        <testCase name="Mask Formatter mask:Licence plate invalid" duration="2"/>
+        <testCase name="Mask Formatter mask:Licence plate invalid for being too short" duration="1"/>
+        <testCase name="Mask Formatter mask:Licence plate invalid for being too short with placeholder" duration="0"/>
+        <testCase name="Mask Formatter mask:Licence plate invalid" duration="1"/>
+        <testCase name="Mask Formatter mask:Licence plate with AlphaNumerical Mask" duration="1"/>
+        <testCase name="Mask Formatter mask:Licence plate with AlphaNumerical Mask with placeholder" duration="0"/>
+        <testCase name="Mask Formatter mask:Licence plate invalid" duration="0"/>
+        <testCase name="Mask Formatter mask:Licence plate with AlphaNumerical Mask" duration="0"/>
+        <testCase name="Mask Formatter mask:Licence plate with AlphaNumerical Mask with placeholder" duration="0"/>
+        <testCase name="Mask Formatter mask:Licence plate invalid" duration="1"/>
+        <testCase name="Mask Formatter mask:Licence plate with AlphaNumerical Mask" duration="1"/>
+        <testCase name="Mask Formatter mask:Licence plate with AlphaNumerical Mask with placeholder" duration="0"/>
+        <testCase name="Mask Formatter mask:Licence plate invalid" duration="1"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/CriteriaParameter.spec.ts">
+        <testCase name="StringUtils it should return the correct values of &quot;value&quot; and &quot;type&quot; through the getters methods initial setted by the constructor" duration="67"/>
+        <testCase name="StringUtils it should return the correct values of &quot;value&quot; and &quot;type&quot; through the getters methods initial setted by the setters methods" duration="1"/>
+        <testCase name="StringUtils it should return the correct JSON/Object value through the buildParam method" duration="0"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/TimeFormatter.spec.ts">
+        <testCase name="TimeFormatter Case: input string unformated with showSeconds" duration="3"/>
+        <testCase name="TimeFormatter Case: input string unformated without showSeconds" duration="1"/>
+        <testCase name="TimeFormatter Case: validateTime" duration="1"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/CriteriaModel.spec.ts">
+        <testCase name="StringUtils it should return the undefined and [] to Criteria Props through new class with empty constructor" duration="21"/>
+        <testCase name="StringUtils it should modify &quot;expressions&quot; and &quot;parameters&quot; properties through Setters methods" duration="1"/>
+        <testCase name="StringUtils it should return &quot;expression&quot; and &quot;parameters&quot; setted through constructor method" duration="0"/>
+        <testCase name="StringUtils it should return a Criteria class with &quot;expression&quot; and &quot;parameters&quot; as needed setted through &quot;append&quot; method" duration="2"/>
+        <testCase name="StringUtils it should return a Criteria class with &quot;Criteria class&quot; and &quot;parameters&quot; concatenaded as needed setted through &quot;append&quot; method" duration="65"/>
+        <testCase name="StringUtils it should return undefined as &quot;expression&quot; and &quot;[]&quot; as parameters as we use an empty criteria as first entry in the constructor" duration="1"/>
+        <testCase name="StringUtils it should return a Criteria class with &quot;Expression&quot; and &quot;parameters&quot; concatenaded as needed setted through &quot;OR&quot; method" duration="1"/>
+        <testCase name="StringUtils it should return a Criteria class with &quot;Criteria class&quot; and &quot;parameters&quot; concatenaded as needed setted through &quot;OR&quot; method" duration="0"/>
+        <testCase name="StringUtils it should return a Criteria class with &quot;Criteria class&quot; and &quot;parameters&quot; concatenaded as needed setted through &quot;OR&quot; method" duration="1"/>
+        <testCase name="StringUtils it should return a Criteria class with &quot;Expression&quot; and &quot;parameters&quot; concatenaded as needed setted through &quot;AND&quot; method" duration="10"/>
+        <testCase name="StringUtils it should return a Criteria class with &quot;Criteria class&quot; and &quot;parameters&quot; concatenaded as needed setted through &quot;AND&quot; method" duration="1"/>
+        <testCase name="StringUtils it should return a Criteria class with &quot;Criteria class&quot; and &quot;parameters&quot; concatenaded as needed setted through &quot;AND&quot; method" duration="0"/>
+        <testCase name="StringUtils it should return a toJSON object with &quot;Criteria class&quot; and &quot;parameters&quot; concatenaded as needed setted through &quot;AND&quot; method" duration="0"/>
+        <testCase name="StringUtils it should return a toJSON object with through empty constructor" duration="0"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/NumberUtils.spec.ts">
+        <testCase name="StringUtils stringToNumber" duration="77"/>
+        <testCase name="StringUtils format" duration="108"/>
+        <testCase name="StringUtils format without formatnumber parameter" duration="1"/>
+        <testCase name="StringUtils format without formatnumber parameter" duration="1"/>
+        <testCase name="StringUtils format round number" duration="2"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/StringUtils.spec.ts">
+        <testCase name="StringUtils valor vazio" duration="6"/>
+        <testCase name="StringUtils valor em branco" duration="1"/>
+        <testCase name="StringUtils valor null" duration="0"/>
+        <testCase name="StringUtils valor undefined" duration="0"/>
+        <testCase name="StringUtils valor 0" duration="1"/>
+        <testCase name="StringUtils com valor" duration="0"/>
+        <testCase name="StringUtils substitui vogais com acento por vogais sem acento" duration="1"/>
+        <testCase name="StringUtils should return the original value when called with an object without a toString method" duration="72"/>
+        <testCase name="StringUtils should return the original value when called with undefined" duration="1"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/OverflowWatcher.spec.ts">
+        <testCase name="OverflowWatcher should initialize with provided parameters" duration="87"/>
+        <testCase name="OverflowWatcher should disconect  ResizeObserver when destroy is called" duration="3"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate" duration="110"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate with childSpan" duration="72"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate with childSpan when notOverFlow is empty" duration="13"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate with childSpan considering overflowed elements" duration="9"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate with empty list" duration="5"/>
+        <testCase name="OverflowWatcher should ignore elements that can not overflow" duration="79"/>
+        <testCase name="OverflowWatcher Should not call callback on forceUpdate" duration="1"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/DataUnitStorage.spec.ts">
+        <testCase name="DataUnitStorage put should store a DataUnit instance in the DataUnitStorage" duration="7"/>
+        <testCase name="DataUnitStorage get should return the stored DataUnit instance from the DataUnitStorage" duration="1"/>
+        <testCase name="DataUnitStorage get should return undefined if the DataUnit instance is not found in the DataUnitStorage" duration="1"/>
+        <testCase name="DataUnitStorage remove should remove the specified DataUnit instance from the DataUnitStorage" duration="0"/>
+        <testCase name="DataUnitStorage remove should remove the DataUnit instance with the specified name from the DataUnitStorage" duration="1"/>
+        <testCase name="DataUnitStorage remove should not remove any DataUnit instance if the specified DataUnit instance or name is not found in the DataUnitStorage" duration="0"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/ElementIDUtils.spec.ts">
+        <testCase name="addIDInfo 1 - should add data-element-id with valid id &quot;movFinanceira_snkApplication&quot;" duration="14"/>
+        <testCase name="addIDInfo 2 - should add data-element-id with valid id &quot;brComSankhyaFinCadMovimentacaofinanceira_snkApplication&quot;" duration="1"/>
+        <testCase name="addIDInfo 3 - should add data-element-id with valid id &quot;movFinanceira_br.com.sankhya.fin.cad.movimentacaoFinanceira&quot;" duration="2"/>
+        <testCase name="addIDInfo 4 - should add data-element-id with valid id &quot;meuID2_snkApplication&quot;" duration="4"/>
+        <testCase name="addIDInfo 5 - should add data-element-id with valid id &quot;movFinanceira_snkApplication&quot;" duration="1"/>
+        <testCase name="addIDInfo 6 - should add data-element-id with valid id &quot;movFinanceira_snkApplication&quot;" duration="1"/>
+        <testCase name="addIDInfo 7 - should add data-element-id with valid id &quot;componenteNameTest_snkApplication&quot;" duration="49"/>
+        <testCase name="addIDInfo 8 - should add data-element-id with valid id &quot;componentLabel_snkApplication&quot;" duration="1"/>
+        <testCase name="addIDInfo 9 - should add data-element-id with valid id &quot;dataunitFinanceiro_br.com.sankhya.fin.cad.movimentacaoFinanceira&quot;" duration="2"/>
+        <testCase name="addIDInfo 10 - should add data-element-id with valid id &quot;dataunitFinanceiro_meuIDTeste_br.com.sankhya.fin.cad.movimentacaoFinanceira&quot;" duration="9"/>
+        <testCase name="addIDInfo 11 - should add data-element-id with valid id &quot;dataunitFinanceiro_meuIDTeste_movimentacaoFinanceira&quot;" duration="1"/>
+        <testCase name="addIDInfo 12 - should add data-element-id with valid id &quot;dataunitFinanceiro_movFinanceira_movimentacaoFinanceira&quot;" duration="1"/>
+        <testCase name="addIDInfo 13 - should add data-element-id with valid id &quot;dataunitFinanceiro_meuIDTeste_movimentacaoFinanceira&quot;" duration="1"/>
+        <testCase name="addIDInfo 14 - should add data-element-id with valid id &quot;dataunitFinanceiro_meuIdTeste_movimentacaoFinanceira&quot;" duration="1"/>
+        <testCase name="addIDInfo 15 - should add data-element-id with valid id &quot;dataunitFinanceiro_meuIdTeste_snkApplication&quot;" duration="1"/>
+        <testCase name="addIDInfo 16 - should add data-element-id with valid id &quot;dataunitFinanceiro_meuIdTeste_snkApplication&quot;" duration="1"/>
+        <testCase name="addIDInfo 17 - should add data-element-id with valid id &quot;movFinanceira_movimentacaoFinanceira&quot;" duration="1"/>
+        <testCase name="addIDInfo 18 - should add data-element-id with valid id &quot;movFinanceira_movimentacaoFinanceira&quot;" duration="1"/>
+        <testCase name="addIDInfo 19 - should add data-element-id with valid id &quot;movFinanceira_movimentacaoFinanceira&quot;" duration="0"/>
+        <testCase name="addIDInfo 20 - should add data-element-id with valid id &quot;movFinanceira_movimentacaoFinanceira&quot;" duration="1"/>
+        <testCase name="addIDInfo 21 - should add data-element-id with valid id &quot;movFinanceira_movimentacaoFinanceira&quot;" duration="1"/>
+        <testCase name="addIDInfo 22 - should add data-element-id with valid id &quot;bancoObrigatorio_movimentacaoFinanceira&quot;" duration="1"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/ElementUtils.spec.ts">
+        <testCase name="calcMarginSize should calculate correctly the size of horizontal margin" duration="27"/>
+        <testCase name="calcMarginSize should calculate correctly the size of vertical margin" duration="1"/>
+        <testCase name="calcMarginSize should threat values defined as zero" duration="3"/>
+    </file>
+</unitTest>

package/setupTests.js

@@ -0,0 +1 @@
+global.ResizeObserver = require('resize-observer-polyfill');

package/sonar-project.properties

@@ -0,0 +1,10 @@
+sonar.testExecutionReportPaths=./reports/test-report.xml
+sonar.typescript.lcov.reportPaths=./coverage/lcov.info
+sonar.test.inclusions=coverage/**,**/test/*.e2e.ts,**/test/*.spec.ts,**/test/*.spec.tsx,**/utils/*.spec.ts,**/test/**/*.ts
+sonar.tests=test
+sonar.sourceEncoding=UTF-8
+sonar.c.file.suffixes=-
+sonar.cpp.file.suffixes=-
+sonar.objc.file.suffixes=-
+sonar.qualitygate.wait=true
+sonar.host.url=http://sonarqube.sankhya.com.br

package/src/dataunit/DataUnit.ts

@@ -25,6 +25,7 @@ import { getFormattedValue } from "./formatting/PrettyFormatter.js";
 import { v4 as uuid } from "uuid";
 import { DataUnitStorage } from "./DataUnitStorage.js";
 import { getInvalidFieldMessage, InvalidFieldsReducer } from "./state/slice/InvalidFieldsSlice.js";
+import { getLoadingProperties, LoadingPropertiesReducer } from "./state/slice/LoadingProperties.js";
 
 /***
  * `DataUnit`: Atua como uma camada de abstração entre o back-end e a interface do usuário.
@@ -36,7 +37,7 @@ export default class DataUnit {
 
     private _uuid: string;
     private _name: string;
-    private _observers: Array<(action: DataUnitAction) => void>;
+    private _observers: Array<(action: DataUnitAction, options?:DataUnitEventOptions) => void>;
     private _sortingProvider?: SortingProvider;
     private _filterProviders: Map<string, FilterProvider>;
     private _stateManager: StateManager;
@@ -61,6 +62,7 @@ export default class DataUnit {
         this._stateManager = new StateManager(
             [
                 HistReducer,
+                LoadingPropertiesReducer,
                 UnitMetadataReducer,
                 LoadingControlReducer,
                 RecordsReducer,
@@ -114,6 +116,27 @@ export default class DataUnit {
         this._interceptors = [];
     }
 
+    /**
+     * Adiciona uma propriedade transacional que será envida aos 
+     * loaders (dataLoader, saveLoader, removeLoader e recordLoader) na chamada.
+     * Essas propriedades serão limpas ao final da execução de cada método.
+     * 
+     * @param name - Nome da propriedade
+     * @param value - Valor da propriedade
+     * 
+     */
+    public addGlobalLoaderProp(name: string, value: string):void{
+        this.dispatchAction(Action.LOADING_PROPERTY_ADDED, {[name]: value});
+    }
+
+    /**
+     * Retorna as propriedades transacionais adicionados anteriores à chamada.
+     * 
+     * @returns - Todas as propriedades desde o final do último loader.
+     */
+    public getGlobalLoaderProps(): Map<string, string>{
+        return getLoadingProperties(this._stateManager) || new Map();
+    }
 
     public get dataUnitId(): string{
         return this._uuid;
@@ -215,22 +238,24 @@ export default class DataUnit {
             if (await this.dispatchAction(Action.LOADING_DATA, request, executionCtx)) {
                 if (this.dataLoader) {
                     this.dataLoader(this, request).then(
-                        response => {
-                            this.dispatchAction(
+                        async response => {
+                            await this.dispatchAction(
                                 Action.DATA_LOADED, 
                                 {...response, keepSelection: request.keepSelection, filters: request.filters},
                                 executionCtx
                             );
+                            
+                            await this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
 
                             if(selectFirstRecord){
                                 this.requestSelectFirst(executionCtx);
                             }
-
                             resolve(response);
                         }
                     ).catch(error => {
                         console.error(error);
                         const {errorCode} = error;
+                        this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
                         fail(new ErrorException("Erro ao carregar registros", error, errorCode))
                     });
                 }
@@ -431,6 +456,7 @@ export default class DataUnit {
                                 const changes: Array<Change> = this.getAllChangesToSave();
 
                                 this.saveLoader(this, changes).then((records) => {
+                                    this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
                                     const recordsByDataUnit = this.getRecordsByDataUnit(records);
 
                                     const dispatchPromisses = [];
@@ -445,9 +471,11 @@ export default class DataUnit {
                                     Promise.all(dispatchPromisses).then(() => resolve());
                                 }).catch(cause => {
                                     const {errorCode} = cause;
+                                    this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
                                     fail(new ErrorException("Erro ao salvar alterações", cause, errorCode));
                                 });
                             } else {
+                                this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
                                 resolve();
                             }
                         });
@@ -536,6 +564,7 @@ export default class DataUnit {
     public async removeRecords(recordIds: Array<string>, cachedRecords: Array<Record>, buffered: boolean = false, executionCtx?: ExecutionContext, silent: boolean = false): Promise<Array<string>> {
         if (recordIds) {
             if (buffered || !this.removeLoader) {
+                this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
                 this.dispatchAction(Action.RECORDS_REMOVED, { records: recordIds, cachedRecords, buffered: true }, executionCtx);
             } else {
                 if (await this.dispatchAction(Action.REMOVING_RECORDS, {silent}, executionCtx)) {
@@ -553,9 +582,11 @@ export default class DataUnit {
                                     const selectionAfterRemove = [currentRecordsKeys[nextIndex]];
 
                                     this.dispatchAction(Action.RECORDS_REMOVED, { records: removedIds, cachedRecords, removedIndex, buffered: false, selectionAfterRemove }, executionCtx);
+                                    this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
                                     resolve(removedIds);
                                 }
                             ).catch(error => {
+                                this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
                                 const {errorCode} = error;
                                 fail(new ErrorException("Erro ao remover registros", error, errorCode))
                             });
@@ -612,15 +643,14 @@ export default class DataUnit {
      * 
     */
     public getFormattedValue(fieldName: string, value?: any): string {
-        
         const descriptor = this.getField(fieldName);
-        if (value == undefined) {
+        if (value === undefined) {
             value = this.getFieldValue(fieldName);
         } else if (typeof value === "string" && descriptor?.dataType != DataType.TEXT){
             value = this.valueFromString(fieldName, value);
         }
 
-        if(value == undefined){
+        if(value === undefined){
             return "";
         }
 
@@ -918,7 +948,7 @@ export default class DataUnit {
      * @returns - Promise que será resolvida quando o novo valor for persistido no state.
      * 
     */
-    public async setFieldValue(fieldName: string, newValue: any, records?: Array<string>): Promise<boolean> {
+    public async setFieldValue(fieldName: string, newValue: any, records?: Array<string>, options?:DataUnitEventOptions): Promise<boolean> {
 
         if(!this.hasNewRecord() && !this.getSelectedRecord())  await this.addRecord();
         
@@ -937,7 +967,7 @@ export default class DataUnit {
         }
 
         if (currentValue !== typedValue) {
-            const promise = this.dispatchAction(Action.DATA_CHANGED, { [fieldName]: typedValue, records }, undefined);
+            const promise = this.dispatchAction(Action.DATA_CHANGED, { [fieldName]: typedValue, records }, undefined, options);
             this._savingLockers.push(promise);
             return promise;
         }
@@ -1404,7 +1434,7 @@ export default class DataUnit {
      * @returns - Verdadeiro se ação iniciada.
      * 
     */
-    private async dispatchAction(actionType: Action, payload?: any, executionCtx?: ExecutionContext): Promise<boolean> {
+    private async dispatchAction(actionType: Action, payload?: any, executionCtx?: ExecutionContext, options?:DataUnitEventOptions): Promise<boolean> {
         return new Promise(async resolve => {
             let action = new DataUnitAction(actionType, payload);
             if (executionCtx && executionCtx.before) {
@@ -1414,7 +1444,7 @@ export default class DataUnit {
                 action = await this.intercept(action, this._interceptors.values());
             }
             if (action) {
-                this.doDispatchAction(action);
+                this.doDispatchAction(action, options);
                 if (executionCtx && executionCtx.after) {
                     executionCtx.after(action)
                 }
@@ -1452,7 +1482,7 @@ export default class DataUnit {
      * @param action - Ações em execução no DataUnit.
      * 
     */
-    private doDispatchAction(action: DataUnitAction): void {
+    private doDispatchAction(action: DataUnitAction, options:DataUnitEventOptions = {}): void {
         this._stateManager.process(action);
         this?._parentDataUnit?.dispatchAction(Action.CHILD_CHANGED, { srcAction: action, srcDataUnit: this });
         this._observers.forEach(f => {
@@ -1461,7 +1491,7 @@ export default class DataUnit {
             should be continued
             */
             try {
-                f(action);
+                f(action, options);
             } catch (e) {
                 console.warn("[DataUnit] error while call observer", e);
             }
@@ -1500,7 +1530,7 @@ export default class DataUnit {
      * @param observer - Função que recebe como parâmetro as ações que serão monitoradas.
      * 
     */
-    public subscribe(observer: (action: DataUnitAction) => void) {
+    public subscribe(observer: (action: DataUnitAction) => void | Promise<void>) {
         this._observers.push(observer);
     }
 
@@ -1527,12 +1557,16 @@ export default class DataUnit {
             const selection = getSelection(this._stateManager);
             this.dispatchAction(Action.LOADING_RECORD, selection);
             
-            if(!this.dataLoader) return;
-            if(!this.recordLoader) return;
+            if(!this.recordLoader || !this.dataLoader) {
+                this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
+                return;
+            }
             
             this.recordLoader(this, selection).then(response => {
                 this.dispatchAction(Action.RECORD_LOADED, response)
+                this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
             }).catch(cause => {
+                this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
                 const {errorCode} = cause;
                 fail(new ErrorException("Erro ao recarregar registro", cause, errorCode));
             });
@@ -1697,12 +1731,21 @@ export default class DataUnit {
         return selection?.recordIds || [];
     }
 
+    /**
+     * Adiciona um campo stand-alone ao dataUnit.
+     * 
+     * @deprecated - metodo depreciado, utilizar o metodo addField
+     */
+    public addStandAloneField() : void {
+        console.warn("metodo depreciado, para adicionar um campo standAlone, utilizar o metodo addField")
+    }
+
     /**
      * Adiciona um campo stand-alone ao dataUnit.
      * 
      * @param field - Campo a ser adicionado.
      */
-    public addStandAloneField(field: Omit<FieldDescriptor, 'standAlone'>) : void {
+    public addField(field: Omit<FieldDescriptor, 'standAlone'>) : void {
         const standAloneField = {...field, standAlone: true};
         this.metadata = {...this.metadata, fields: [...this.metadata.fields, standAloneField]};
     }
@@ -1908,3 +1951,5 @@ export class SelectionInfo{
         return this.length === 0;
     }
 }
+
+export type DataUnitEventOptions = {[key:string]: any};

package/src/dataunit/formatting/PrettyFormatter.ts

@@ -10,10 +10,10 @@ export const getFormattedValue = (value: any, descriptor?: FieldDescriptor) => {
     }
 
     if(descriptor?.dataType === DataType.OBJECT){
-        if(Object.hasOwn(value, "value")){
+        if(value && Object.hasOwn(value, "value")){
             return getSearchFormat(value, descriptor);
         }
-        return value == undefined ? "" : value.toString();
+        return !value ? "" : value.toString();
     }
 
     if(descriptor?.userInterface === UserInterface.OPTIONSELECTOR){
@@ -53,6 +53,7 @@ export const getFormattedValue = (value: any, descriptor?: FieldDescriptor) => {
 }
 
 const getNumberFormat = (value: any, descriptor: FieldDescriptor) => {
+    if(!value) return "";
     if(descriptor.userInterface === UserInterface.INTEGERNUMBER){
         return value;
     }
@@ -79,10 +80,12 @@ const getOptionFormat = (value: any, descriptor: FieldDescriptor) => {
         options = JSON.parse(prop);
     } else {
         options = {};
-        prop.forEach(opt => options[opt.label] = opt.value);
+        if(prop != undefined){
+            prop.forEach(opt => options[opt.label] = opt.value);
+        }
     }
 
-    if(typeof value === "object"){
+    if(value && typeof value === "object" ){
         value = value.value
     }
 
@@ -90,7 +93,7 @@ const getOptionFormat = (value: any, descriptor: FieldDescriptor) => {
         return options[value];
     }
 
-    return value;     
+    return value ?? "";
 }
 
 

package/src/dataunit/metadata/DataType.ts

@@ -67,7 +67,16 @@ export const getConvertedValue = (dataType: DataType, value: any): any => {
     case DataType.NUMBER:
       return value === "" || isNaN(Number(value)) ? null : Number(value);
     case DataType.OBJECT:
-      return typeof value === "string" ? JSON.parse(value) : value;
+    //Caso de uso campo DataType do tipo STRING e UserInterface do tipo TEXT, que tem relacionamento (TGFPRO.GRUPOPIS)
+    if(typeof value === "string") {
+        try{
+            return JSON.parse(value);
+        }catch(e){
+            console.warn(`Erro ao fazer parse do valor ${value} para objeto, dataType: ${dataType}`);
+        }
+      }
+
+      return value;
     case DataType.BOOLEAN:
       if (typeof value === "string") {
         return Boolean(value === 'true');
@@ -110,6 +119,9 @@ export const toString = ( dataType: DataType|undefined, value: any): string => {
         } else if (dataType === DataType.DATE) {
             if (typeof value === "string") {
                 value = DateUtils.strToDate(value);
+                if (value == undefined) {
+                    return value;
+                }
             }
             return DateUtils.formatRfc3339(value as Date);
         } else {

package/src/dataunit/state/action/DataUnitAction.ts

@@ -63,6 +63,8 @@ export enum Action{
     CHILD_CHANGED = "childChanged",
 
     FIELD_INVALIDATED = "fieldInvalidated",
-    INVALIDATE_CLEAN = "invalidateClean"
+    INVALIDATE_CLEAN = "invalidateClean",
     
+    LOADING_PROPERTY_ADDED = "loadingPropertyAdded",
+    LOADING_PROPERTIES_CLEANED = "loadingPropertiesCleaned"
 }

package/src/dataunit/state/slice/ChangesSlice.ts

@@ -94,27 +94,28 @@ export const getChangedFieldValue = (fieldName: string, record: Record, stateMan
 }
 
 export const getChangesToSave = (dataUnit: string, stateManager: StateManager): Array<Change> => {
-    const result: Array<Change> = [];
-
+    
     const changes = getChanges(stateManager);
     const selectedRecords = getSelectionRecords(stateManager) || [];
-    const records: Set<Record> = new Set(
+    const records: Map<string, Record> = new Map(
         getRecords(stateManager)
         .concat(
-            selectedRecords
-                .filter(record => !isAddedRecord(record.__record__id__, stateManager)
-            )
+            selectedRecords.filter(record => !isAddedRecord(record.__record__id__, stateManager))
         )
+        .map(r => [r.__record__id__, r])
     );
-
-    records?.forEach(r => {
-        if(changes){
-            const c = changes.get(r.__record__id__);
-            if (c) {
-                result.push(new Change(dataUnit, r, c, ChangeOperation.UPDATE,  r.__record__source__id__));
+    
+    const result: Array<Change> = [];
+    
+    if(changes != undefined){
+        Array.from(changes.entries())
+        .forEach(([recordId, change]) =>{
+            const record = records.get(recordId);
+            if(record != undefined){
+                result.push(new Change(dataUnit, record, change, ChangeOperation.UPDATE,  record.__record__source__id__));
             }
-        }
-    });
+        });
+    }
 
     const addedRecords = getAddedRecords(stateManager);
     if (addedRecords) {

package/src/dataunit/state/slice/InvalidFieldsSlice.ts

@@ -15,6 +15,8 @@ class InvalidFieldsReducerImpl implements ActionReducer{
                 return makeInvalid(currentState, action.payload);
             case Action.INVALIDATE_CLEAN:
                 return clearRecord(currentState, action.payload);
+            case Action.EDITION_CANCELED:
+                return undefined;
         }
 
         return currentState;

package/src/dataunit/state/slice/LoadingProperties.ts

@@ -0,0 +1,37 @@
+
+import { ActionReducer, StateAction } from "../StateManager.js";
+import { Action } from "../action/DataUnitAction.js";
+import StateManager from "../StateManager.js";
+
+class LoadingPropertiesImpl implements ActionReducer{
+    
+    public sliceName: string = "loadingProperties";
+
+    public reduce(_stateManager:StateManager, currentState: Map<string, string>, action: StateAction): Map<string, string>|undefined {
+        switch(action.type){
+            case Action.LOADING_PROPERTY_ADDED:
+                return buildNewState(currentState, action.payload);
+            case Action.LOADING_PROPERTIES_CLEANED:
+                return undefined;
+        }
+        return currentState;
+    }
+}
+
+export const LoadingPropertiesReducer = new LoadingPropertiesImpl();
+
+export const getLoadingProperties = (stateManager: StateManager): Map<string, string>|undefined => {
+    return stateManager.select(LoadingPropertiesReducer.sliceName, (state: Map<string, string>) => state);
+};
+
+function buildNewState(currentState: Map<string, string>, payload: any): Map<string, string>{
+    const newState =  new Map(currentState);
+    if(payload != undefined){
+        for (const [key, value] of Object.entries(payload)) {
+            if(typeof key === "string" && typeof value === "string"){
+                newState.set(key, value);
+            }
+        }
+    }
+    return newState;
+}

package/src/dataunit/state/slice/SelectionSlice.ts

@@ -17,7 +17,8 @@ class SelectionReducerImpl implements ActionReducer {
                 return !action.payload?.keepSelection ? undefined : currentState;
             case Action.RECORDS_ADDED:
             case Action.RECORDS_COPIED:
-                return {currentSelection: action.payload.map((r: Record)=>r.__record__id__), lastSelection: currentState?.currentSelection};
+                const lastSelection = currentState?.currentSelection || [];
+                return {currentSelection: action.payload.map((r: Record)=>r.__record__id__), lastSelection};
             case Action.DATA_SAVED:
                 return {currentSelection: updateSavedIds(stateManager, action.payload.records)};
             case Action.RECORDS_REMOVED:
@@ -67,7 +68,7 @@ class SelectionReducerImpl implements ActionReducer {
                 if(currentState?.lastSelection){
                     return { currentSelection: currentState.lastSelection };
                 }
-                break;
+                return { currentSelection: [] }
         }
 
         return currentState;

package/src/index.ts

@@ -9,7 +9,7 @@ import { HttpProvider } from "./http/HttpProvider.js";
 import { SkwHttpProvider } from "./http/SkwHttpProvider.js";
 import { RequestMetadata } from "./http/RequestMetadata.js";
 import { AuthorizedServiceCaller } from "./http/AuthorizedServiceCaller.js";
-import DataUnit, {SavedRecord, Record, Change, ChangeOperation, DUActionInterceptor, WaitingChange, PageRequest, QuickFilter, SelectionMode, SelectionInfo} from "./dataunit/DataUnit.js";
+import DataUnit, {SavedRecord, Record, Change, ChangeOperation, DUActionInterceptor, WaitingChange, PageRequest, QuickFilter, SelectionMode, SelectionInfo, DataUnitEventOptions} from "./dataunit/DataUnit.js";
 import { DataType } from "./dataunit/metadata/DataType.js";
 import { UnitMetadata, FieldDescriptor, UserInterface, Sort, SortMode, SortingProvider, Filter, DependencyType, ChildDescriptor, ChildLink } from "./dataunit/metadata/UnitMetadata.js";
 import { DataUnitAction, Action, ExecutionContext } from "./dataunit/state/action/DataUnitAction.js";
@@ -39,6 +39,7 @@ import { IRepositoryIndex } from "./repository/indexeddb/IRepositoryIndex.js"
 import { FieldComparator } from "./dataunit/sorting/FieldComparator.js";
 import { KeyboardManager } from "./utils/KeyboardManager/index.js";
 import { SearchUtils } from "./utils/SearchUtils.js";
+import OverflowWatcher, { OnOverflowCallBack, OverflowDirection, OverFlowWatcherParams, OVERFLOWED_CLASS_NAME } from "./utils/OverflowWatcher/index.js";
 
 /*Classes públicas no pacote*/
 export {
@@ -106,4 +107,10 @@ export {
     defaultDataLoader,
     KeyboardManager,
     SearchUtils,
+    OverflowWatcher,
+    OnOverflowCallBack,
+    OverflowDirection,
+    OverFlowWatcherParams,
+    OVERFLOWED_CLASS_NAME,
+    DataUnitEventOptions
 };

package/src/utils/ElementUtils.ts

@@ -0,0 +1,10 @@
+import { OverflowDirection } from './OverflowWatcher/types/overflow-direction.js';
+
+export function calcMarginSize(el:Element, scrollDirection: OverflowDirection){
+  const computedStyle = getComputedStyle(el);
+  if(OverflowDirection.HORIZONTAL === scrollDirection){
+    return (parseInt(computedStyle.marginLeft || '0') + parseInt(computedStyle.marginRight || '0'));
+  }
+
+  return (parseInt(computedStyle.marginTop || '0') + parseInt(computedStyle.marginBottom || '0'));
+}