@sankhyalabs/core 5.20.0-dev.9 → 5.20.0-rc.10

package/jest.config.ts

@@ -1,4 +1,6 @@
 module.exports = {
+    preset: 'ts-jest',
+    setupFiles: ['./setupTests.js'],
     transform: {'^.+\\.ts?$': 'ts-jest'},
     testEnvironment: 'jsdom',
     testRegex: '\\.(test|spec)?\\.(ts|tsx)$',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sankhyalabs/core",
-  "version": "5.20.0-dev.9",
+  "version": "5.20.0-rc.10",
   "description": "Modulo core JavaScript da Sankhya.",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -45,6 +45,7 @@
     "jest": "^29.4.1",
     "jest-environment-jsdom": "^29.4.1",
     "jest-sonar-reporter": "^2.0.0",
+    "resize-observer-polyfill": "^1.5.1",
     "ts-jest": "^29.0.5",
     "ts-node": "^10.9.1",
     "typedoc": "^0.25.13",

package/reports/test-report.xml

@@ -0,0 +1,151 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<unitTest version="1">
+    <file path="/builds/dti/design-system/sankhyacore/test/util/MaskFormatter.spec.ts">
+        <testCase name="Mask Formatter mask:CPF complete valid" duration="7"/>
+        <testCase name="Mask Formatter mask:CPF complete valid literals" duration="1"/>
+        <testCase name="Mask Formatter mask:CPF incomplete valid" duration="1"/>
+        <testCase name="Mask Formatter mask:CPF incomplete valid placeholder" duration="10"/>
+        <testCase name="Mask Formatter mask:CPF too long valid" duration="1"/>
+        <testCase name="Mask Formatter mask:CPF invalid for string" duration="111"/>
+        <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="0"/>
+        <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="2"/>
+        <testCase name="Mask Formatter mask:Licence plate with AlphaNumerical Mask" duration="79"/>
+        <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="0"/>
+        <testCase name="Mask Formatter mask:Licence plate with AlphaNumerical Mask with placeholder" duration="1"/>
+        <testCase name="Mask Formatter mask:Licence plate invalid" duration="1"/>
+        <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"/>
+    </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="13"/>
+        <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="1"/>
+        <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="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;append&quot; method" duration="1"/>
+        <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="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="3"/>
+        <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="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;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="1"/>
+        <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="1"/>
+        <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="87"/>
+        <testCase name="StringUtils format" duration="93"/>
+        <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="83"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/StringUtils.spec.ts">
+        <testCase name="StringUtils valor vazio" duration="2"/>
+        <testCase name="StringUtils valor em branco" duration="0"/>
+        <testCase name="StringUtils valor null" duration="1"/>
+        <testCase name="StringUtils valor undefined" duration="0"/>
+        <testCase name="StringUtils valor 0" duration="0"/>
+        <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="2"/>
+        <testCase name="StringUtils should return the original value when called with undefined" duration="1"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/http/HttpProvider.spec.ts">
+        <testCase name="HttpProvider Metodo GET" duration="1"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/util/OverflowWatcher.spec.ts">
+        <testCase name="OverflowWatcher should initialize with provided parameters" duration="78"/>
+        <testCase name="OverflowWatcher should disconect  ResizeObserver when destroy is called" duration="2"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate" duration="307"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate with childSpan" duration="98"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate with childSpan when notOverFlow is empty" duration="87"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate with childSpan considering overflowed elements" duration="7"/>
+        <testCase name="OverflowWatcher Should call callback on forceUpdate with empty list" duration="4"/>
+        <testCase name="OverflowWatcher should ignore elements that can not overflow" duration="190"/>
+        <testCase name="OverflowWatcher Should not call callback on forceUpdate" duration="1"/>
+    </file>
+    <file path="/builds/dti/design-system/sankhyacore/test/http/SkwHttpProvider.ts.spec.ts">
+        <testCase name="HttpProvider Metodo POST" 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="1"/>
+        <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="0"/>
+        <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="5"/>
+        <testCase name="TimeFormatter Case: input string unformated without showSeconds" duration="0"/>
+        <testCase name="TimeFormatter Case: validateTime" duration="2"/>
+    </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="68"/>
+        <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="1"/>
+        <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="10"/>
+        <testCase name="addIDInfo 2 - should add data-element-id with valid id &quot;brComSankhyaFinCadMovimentacaofinanceira_snkApplication&quot;" duration="2"/>
+        <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="1"/>
+        <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="1"/>
+        <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="2"/>
+        <testCase name="addIDInfo 11 - should add data-element-id with valid id &quot;dataunitFinanceiro_meuIDTeste_movimentacaoFinanceira&quot;" duration="2"/>
+        <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="2"/>
+        <testCase name="addIDInfo 14 - should add data-element-id with valid id &quot;dataunitFinanceiro_meuIdTeste_movimentacaoFinanceira&quot;" duration="65"/>
+        <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="10"/>
+        <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/dataunit/formatting/PrettyFormatter.spec.ts">
+        <testCase name="getFormattedValue should return empty string when value is null" duration="5"/>
+        <testCase name="getFormattedValue should return empty string when value is not an array" duration="0"/>
+        <testCase name="getFormattedValue should return empty string when value is an empty array" duration="0"/>
+        <testCase name="getFormattedValue should return file name when value is an array with one file object" duration="0"/>
+        <testCase name="getFormattedValue should return file count when value is an array with multiple file objects" duration="0"/>
+        <testCase name="getFormattedValue should return empty string for undefined file" duration="1"/>
+        <testCase name="getFormattedValue should handle OBJECT type with value field" duration="0"/>
+        <testCase name="getFormattedValue should return empty string when value is undefined" duration="1"/>
+        <testCase name="getFormattedValue should return value as string when value is not an object" duration="0"/>
+        <testCase name="getFormattedValue should return value.toString() when value is an object without value property" duration="0"/>
+        <testCase name="getFormattedValue should handle BOOLEAN type" duration="1"/>
+        <testCase name="getFormattedValue should format numbers correctly" duration="14"/>
+        <testCase name="getFormattedValue should format dates correctly" duration="3"/>
+        <testCase name="getFormattedValue should format times correctly" duration="1"/>
+        <testCase name="getFormattedValue should format datetime correctly" duration="1"/>
+        <testCase name="getFormattedValue should call toString with correct parameters" duration="0"/>
+        <testCase name="getFormattedValue should handle undefined descriptor gracefully" duration="0"/>
+        <testCase name="getFormattedValue should format value correctly with OPTIONSELECTOR and matching option" duration="0"/>
+        <testCase name="getFormattedValue should return value with OPTIONSELECTOR and no matching option" duration="16"/>
+        <testCase name="getFormattedValue should format value correctly with OPTIONSELECTOR and value as object" duration="1"/>
+        <testCase name="getFormattedValue should return empty string with OPTIONSELECTOR and value as null" duration="0"/>
+        <testCase name="getFormattedValue should format value correctly with OPTIONSELECTOR and options as JSON string" duration="0"/>
+        <testCase name="getFormattedValue should return value with OPTIONSELECTOR and options as empty array" duration="0"/>
+        <testCase name="getFormattedValue should format masked values correctly" duration="2"/>
+    </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="35"/>
+        <testCase name="calcMarginSize should calculate correctly the size of vertical margin" duration="2"/>
+        <testCase name="calcMarginSize should threat values defined as zero" duration="20"/>
+    </file>
+</unitTest>

package/setupTests.js

@@ -0,0 +1,7 @@
+global.ResizeObserver = require('resize-observer-polyfill');
+
+if (!Object.hasOwn) {
+  Object.hasOwn = function (obj, prop) {
+    return Object.prototype.hasOwnProperty.call(obj, prop);
+  };
+}

package/sonar-project.properties

@@ -1,7 +1,10 @@
 sonar.testExecutionReportPaths=./reports/test-report.xml
 sonar.typescript.lcov.reportPaths=./coverage/lcov.info
-sonar.test.inclusions="**/test/*.e2e.ts","**/test/*.spec.ts","**/test/*.spec.tsx","**/utils/*.spec.ts"
-sonar.tests=.
+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.objc.file.suffixes=-
+sonar.qualitygate.wait=true
+sonar.host.url=http://sonarqube.sankhya.com.br

package/src/dataunit/DataUnit.ts

@@ -37,17 +37,18 @@ 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;
-    private _interceptors: Array<DUActionInterceptor>;
+    private _interceptors: Map<string, DUActionInterceptor>;
     private _pageSize: number;
     private _childByName = new Map<string, DataUnit>();
     private _parentDataUnit: DataUnit | undefined;
     private _loadingLockers: Promise<void>[];
     private _savingLockers: Promise<any>[] = [];
     private _defaultSorting: Array<Sort>;
+    private _allowReleaseCallbacks: boolean;
     
     public metadataLoader?: (dataUnit: DataUnit) => Promise<UnitMetadata>;
     public dataLoader?: (dataUnit: DataUnit, request: LoadDataRequest) => Promise<LoadDataResponse>;
@@ -79,7 +80,8 @@ export default class DataUnit {
         this._filterProviders = new Map<string, FilterProvider>();
         this._sortingProvider = undefined;
         this._defaultSorting = [];
-        this._interceptors = [];
+        this._allowReleaseCallbacks = true;
+        this._interceptors = new Map();
         this._parentDataUnit = parentDataUnit;
         this._parentDataUnit?.subscribe(this.onDataUnitParentEvent);
         this._loadingLockers = [];
@@ -110,10 +112,12 @@ export default class DataUnit {
      * - Sorting Providers
      */
     public releaseCallbacks(){
+        if(!this._allowReleaseCallbacks) return;
+
         this._observers = [];
         this._filterProviders = new Map<string, FilterProvider>();
         this._sortingProvider = undefined;
-        this._interceptors = [];
+        this._interceptors = new Map();
     }
 
     /**
@@ -180,6 +184,8 @@ export default class DataUnit {
             case Action.NEXT_SELECTED:
             case Action.PREVIOUS_SELECTED:
             case Action.DATA_LOADED:
+            case Action.RECORDS_ADDED:
+            case Action.EDITION_CANCELED:
                 this.clearDataUnit();
                 const selectedRecord = this._parentDataUnit?.getSelectedRecord();
                 if(selectedRecord != undefined && !this.isNewRecord(selectedRecord.__record__id__)){
@@ -241,10 +247,10 @@ export default class DataUnit {
                         async response => {
                             await this.dispatchAction(
                                 Action.DATA_LOADED, 
-                                {...response, keepSelection: request.keepSelection, filters: request.filters},
+                                {...response, keepSelection: request.keepSelection, filters: request.filters, selectFirstRecord},
                                 executionCtx
                             );
-                            
+
                             await this.dispatchAction(Action.LOADING_PROPERTIES_CLEANED);
 
                             if(selectFirstRecord){
@@ -317,13 +323,16 @@ export default class DataUnit {
         
         await this.processLoadingLockers();
 
-        if (this._parentDataUnit && !this._parentDataUnit.getSelectedRecord()) {
+        if (this._parentDataUnit) {
+            const parentRecord = this._parentDataUnit.getSelectedRecord();
+            if(parentRecord == undefined || this._parentDataUnit.isNewRecord(parentRecord.__record__id__)){
                 if(this.records){
                     this.clearDataUnit();
                 }
                 return Promise.resolve({
                     records: []
                 });
+            }
         }
 
         const loadDataRequest = this.getLoadDataRequest(quickFilter, source);
@@ -336,7 +345,7 @@ export default class DataUnit {
      * 
      * @param page - Número da página desejada.
      * @param executionCtx - Contexto de execução do carregamento dos registros do DataUnit.
-     * 
+     *
      * @returns - Registros da página desejada.
      * 
     */
@@ -643,15 +652,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 "";
         }
 
@@ -666,7 +674,7 @@ export default class DataUnit {
      * 
     */
     public addInterceptor(interceptor: DUActionInterceptor): void {
-        this._interceptors.push(interceptor);
+        this._interceptors.set(interceptor.interceptAction.toString(), interceptor);
     }
 
     /**
@@ -677,7 +685,7 @@ export default class DataUnit {
      * 
     */
     public removeInterceptor(interceptor: DUActionInterceptor) {
-        this._interceptors = this._interceptors.filter(i => i !== interceptor);
+        this._interceptors.delete(interceptor.interceptAction.toString())
     }
 
     /**
@@ -949,7 +957,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();
         
@@ -968,7 +976,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;
         }
@@ -1435,17 +1443,17 @@ 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) {
                 action = executionCtx.before(action);
             }
-            if (action && this._interceptors && this._interceptors.length > 0) {
+            if (action && this._interceptors && this._interceptors.size > 0) {
                 action = await this.intercept(action, this._interceptors.values());
             }
             if (action) {
-                this.doDispatchAction(action);
+                this.doDispatchAction(action, options);
                 if (executionCtx && executionCtx.after) {
                     executionCtx.after(action)
                 }
@@ -1483,7 +1491,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 => {
@@ -1492,7 +1500,7 @@ export default class DataUnit {
             should be continued
             */
             try {
-                f(action);
+                f(action, options);
             } catch (e) {
                 console.warn("[DataUnit] error while call observer", e);
             }
@@ -1531,7 +1539,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, options?:DataUnitEventOptions) => void | Promise<void>) {
         this._observers.push(observer);
     }
 
@@ -1765,6 +1773,10 @@ export default class DataUnit {
         return loadingLockerResolver || Promise.resolve;
     }
 
+    public set allowReleaseCallbacks(allow: boolean){
+        this._allowReleaseCallbacks = allow;
+    }
+
     private async processLoadingLockers(){
         if(this._loadingLockers.length) {
             await Promise.all(this._loadingLockers);
@@ -1952,3 +1964,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;
     }
@@ -84,7 +85,7 @@ const getOptionFormat = (value: any, descriptor: FieldDescriptor) => {
         }
     }
 
-    if(typeof value === "object"){
+    if(value && typeof value === "object" ){
         value = value.value
     }
 
@@ -92,7 +93,7 @@ const getOptionFormat = (value: any, descriptor: FieldDescriptor) => {
         return options[value];
     }
 
-    return value;     
+    return value ?? "";
 }
 
 
@@ -103,7 +104,7 @@ const getMask = (value: string, descriptor: FieldDescriptor | undefined): string
     }
 
     const mask = descriptor.properties?.mask;
-    if(mask == undefined){
+    if(mask == undefined || !value){
         return;
     }
 

package/src/dataunit/metadata/DataType.ts

@@ -119,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/slice/SelectionSlice.ts

@@ -68,7 +68,7 @@ class SelectionReducerImpl implements ActionReducer {
                 if(currentState?.lastSelection){
                     return { currentSelection: currentState.lastSelection };
                 }
-                return { currentSelection: [] }
+                return { currentSelection: currentState?.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,7 +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 } from "./utils/OverflowWatcher/index.js";
+import OverflowWatcher, { OnOverflowCallBack, OverflowDirection, OverFlowWatcherParams, OVERFLOWED_CLASS_NAME } from "./utils/OverflowWatcher/index.js";
 
 /*Classes públicas no pacote*/
 export {
@@ -109,5 +109,8 @@ export {
     SearchUtils,
     OverflowWatcher,
     OnOverflowCallBack,
-    OverflowDirection
+    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'));
+}

package/src/utils/ObjectUtils.ts

@@ -84,4 +84,24 @@ export default class ObjectUtils{
     public static equals(obj1: any, obj2: any): any {
       return ObjectUtils.objectToString(obj1) === ObjectUtils.objectToString(obj2);
     }
+
+    /**
+    * Verifica se o objeto está vazio (sem atributos).
+    * 
+    * @param obj - Objeto a ser verificado.
+    * @returns - True caso o objeto esteja vazio.
+    */
+    public static isEmpty(obj: object): boolean{
+      return Object.keys(obj).length === 0 && obj.constructor === Object;
+    }
+
+    /**
+     * Verifica se o objeto NÃO está vazio (sem atributos).
+     * 
+     * @param obj - Objeto a ser verificado.
+     * @returns - True caso o objeto NÃO esteja vazio
+     */
+    public static isNotEmpty(obj: object): boolean{
+      return !this.isEmpty(obj);
+    }
 }