@sankhyalabs/core 5.20.0-dev.1 → 5.20.0-dev.11

package/dist/utils/OverflowWatcher/index.js

@@ -0,0 +1,107 @@
+import { JSUtils } from "../JSUtils.js";
+import { OverflowDirection } from "./types/overflow-direction.js";
+export * from "./types/overflow-direction.js";
+export * from "./types/overflow-callback.js";
+export default class OverflowWatcher {
+    /**
+     * Cria uma instancia do OverflowWatcher
+     *
+     * @param element - Elemento HTML que o overflow será observado.
+     * @param callback - Função que sera chamada quando ocorrer overflow no elemento.
+     * @param overFlowDirection - Indica direção que o overflow será monitorado.
+     * @param deltaSize - Variação de tamanho que será considerada como overflow.
+     */
+    constructor(element, callback, overFlowDirection = OverflowDirection.HORIZONTAL, deltaSize = 10) {
+        this._lastContentRect = undefined;
+        this._scrollDirection = OverflowDirection.HORIZONTAL;
+        this._hiddenItems = [];
+        this._onResize = callback;
+        this._scrollDirection = overFlowDirection;
+        this._resizeObserver = new ResizeObserver(JSUtils.debounce((entries) => this.handleResize(entries), 200));
+        this._resizeObserver.observe(element);
+        this._propSize = this.getPropSizeByDirection();
+        this._deltaSize = deltaSize;
+    }
+    destroy() {
+        this._resizeObserver.disconnect();
+    }
+    handleResize(entries) {
+        if (!entries || entries.length === 0) {
+            return;
+        }
+        const resizeItem = entries[0];
+        const contentRect = resizeItem.contentRect;
+        if (this.isChangedSize(contentRect)) {
+            const children = Array.from(resizeItem.target.children);
+            this.proccessElements(contentRect[this._propSize], children);
+            this._lastContentRect = contentRect;
+        }
+    }
+    isChangedSize(newContentRect) {
+        if (this._lastContentRect == undefined) {
+            return true;
+        }
+        return Math.abs(newContentRect[this._propSize] - this._lastContentRect[this._propSize]) >= this._deltaSize;
+    }
+    getPropSizeByDirection() {
+        if (OverflowDirection.HORIZONTAL === this._scrollDirection) {
+            return "width";
+        }
+        return "height";
+    }
+    proccessElements(elementSize, children) {
+        if (children.length === 0) {
+            return;
+        }
+        const childrenSize = this.calcChildrenSize(children);
+        let diff = Number((elementSize - childrenSize).toFixed(4));
+        if (diff > 0) {
+            this.proccessElementsWithoutOverFlow(diff);
+            return;
+        }
+        this.proccessElementsOverFlow(children, diff);
+    }
+    proccessElementsWithoutOverFlow(diff) {
+        this._hiddenItems.forEach((item) => {
+            if (item.getBoundingClientRect().width < diff) {
+                this._hiddenItems.pop();
+            }
+        });
+        this._onResize(this._hiddenItems);
+    }
+    proccessElementsOverFlow(children, diff) {
+        const elementsOverflow = [];
+        let sumRemovedItems = 0;
+        while (elementsOverflow.length < children.length && sumRemovedItems < (diff * -1)) {
+            const itemToRemove = children.pop();
+            if (itemToRemove != undefined && itemToRemove.style.display === 'none') {
+                continue;
+            }
+            if (itemToRemove != undefined) {
+                elementsOverflow.push(itemToRemove);
+                sumRemovedItems += itemToRemove.getBoundingClientRect()[this._propSize];
+            }
+        }
+        this._hiddenItems = elementsOverflow;
+        this._onResize(elementsOverflow);
+    }
+    calcChildrenSize(children) {
+        let sumChildren = 0;
+        Array.from(children).forEach(el => {
+            sumChildren += el.getBoundingClientRect()[this._propSize];
+            sumChildren += this.calcMarginSize(el);
+        });
+        if (sumChildren > 0) {
+            sumChildren += this._deltaSize;
+        }
+        return sumChildren;
+    }
+    calcMarginSize(el) {
+        const computedStyle = getComputedStyle(el);
+        if (OverflowDirection.HORIZONTAL === this._scrollDirection) {
+            return (parseInt(computedStyle.marginLeft || '0') + parseInt(computedStyle.marginRight || '0'));
+        }
+        return (parseInt(computedStyle.marginTop || '0') + parseInt(computedStyle.marginBottom || '0'));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/OverflowWatcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/OverflowWatcher/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/OverflowWatcher/types/overflow-callback.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Callback que será chamado quando o overflow de um elemento for alterado.
+ *
+ * @param elementsOverFlow - Conjunto de elementos filhos que estão causando overflow no elemento pai.
+ */
+export type OnOverflowCallBack = (elementsOverFlow: Array<Element>) => void;

package/dist/utils/OverflowWatcher/types/overflow-callback.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=overflow-callback.js.map

package/dist/utils/OverflowWatcher/types/overflow-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow-callback.js","sourceRoot":"","sources":["../../../../src/utils/OverflowWatcher/types/overflow-callback.ts"],"names":[],"mappings":""}

package/dist/utils/OverflowWatcher/types/overflow-direction.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Define em qual direção o overflow será observado
+ */
+export declare enum OverflowDirection {
+    'VERTICAL' = 0,
+    'HORIZONTAL' = 1
+}

package/dist/utils/OverflowWatcher/types/overflow-direction.js

@@ -0,0 +1,9 @@
+/**
+ * Define em qual direção o overflow será observado
+ */
+export var OverflowDirection;
+(function (OverflowDirection) {
+    OverflowDirection[OverflowDirection["VERTICAL"] = 0] = "VERTICAL";
+    OverflowDirection[OverflowDirection["HORIZONTAL"] = 1] = "HORIZONTAL";
+})(OverflowDirection || (OverflowDirection = {}));
+//# sourceMappingURL=overflow-direction.js.map

package/dist/utils/OverflowWatcher/types/overflow-direction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow-direction.js","sourceRoot":"","sources":["../../../../src/utils/OverflowWatcher/types/overflow-direction.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,iEAAU,CAAA;IACV,qEAAY,CAAA;AAChB,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B"}

package/jest.config.ts

@@ -2,7 +2,7 @@ module.exports = {
     transform: {'^.+\\.ts?$': 'ts-jest'},
     testEnvironment: 'jsdom',
     testRegex: '\\.(test|spec)?\\.(ts|tsx)$',
-    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'], 
     coverageThreshold: {
       "global": {
         "branches": 10,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sankhyalabs/core",
-  "version": "5.20.0-dev.1",
+  "version": "5.20.0-dev.11",
   "description": "Modulo core JavaScript da Sankhya.",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -10,7 +10,7 @@
     "build": "tsc",
     "build:watch": "tsc --watch",
     "compile": "tsc",
-    "test": "jest",
+    "test": "jest --coverage --silent --testResultsProcessor jest-sonar-reporter",
     "coverage": "jest --coverage",
     "serve": "es-dev-server --node-resolve --watch",
     "eslint": "eslint src/**",
@@ -43,11 +43,18 @@
     "eslint-plugin-import": "^2.26.0",
     "husky": "^8.0.3",
     "jest": "^29.4.1",
+    "jest-sonar-reporter": "^2.0.0",
     "jest-environment-jsdom": "^29.4.1",
     "ts-jest": "^29.0.5",
     "ts-node": "^10.9.1",
-    "typedoc": "^0.23.24",
-    "typedoc-plugin-markdown": "^3.14.0",
+    "typedoc": "^0.25.13",
+    "typedoc-plugin-markdown": "^4.0.1",
     "typescript": "^4.9.5"
+  },
+  "jestSonar": {
+    "sonar56x": true,
+    "reportPath": "reports",
+    "reportFile": "test-report.xml",
+    "indent": 4
   }
 }

package/sonar-project.properties

@@ -0,0 +1,7 @@
+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.c.file.suffixes=-
+sonar.cpp.file.suffixes=-
+sonar.objc.file.suffixes=-

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.
@@ -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,18 +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(Action.DATA_LOADED, {...response, keepSelection: request.keepSelection}, executionCtx);
+                        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))
                     });
                 }
@@ -427,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 = [];
@@ -441,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();
                             }
                         });
@@ -532,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)) {
@@ -549,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))
                             });
@@ -608,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 "";
         }
 
@@ -1523,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));
             });
@@ -1693,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]};
     }

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){
@@ -79,10 +79,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 +92,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');

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

@@ -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 } from "./utils/OverflowWatcher/index.js";
 
 /*Classes públicas no pacote*/
 export {
@@ -106,4 +107,7 @@ export {
     defaultDataLoader,
     KeyboardManager,
     SearchUtils,
+    OverflowWatcher,
+    OnOverflowCallBack,
+    OverflowDirection
 };