@sankhyalabs/core 5.3.0 → 5.4.1

package/.docs/classes/ArrayUtils.md

@@ -47,7 +47,7 @@ Filtra um array a partir de um critério textual.
 
 #### Defined in
 
-src/utils/ArrayUtils.ts:16
+src/utils/ArrayUtils.ts:17
 
 ___
 
@@ -71,7 +71,7 @@ Converte texto para caixa alta e substitui caracteres acentuados.
 
 #### Defined in
 
-src/utils/ArrayUtils.ts:34
+src/utils/ArrayUtils.ts:35
 
 ___
 
@@ -96,4 +96,4 @@ Ordena valores de um array alfabeticamente.
 
 #### Defined in
 
-src/utils/ArrayUtils.ts:44
+src/utils/ArrayUtils.ts:45

package/.docs/classes/NumberUtils.md

@@ -13,11 +13,13 @@
 ### Methods
 
 - [changeFormat](NumberUtils.md#changeformat)
+- [compare](NumberUtils.md#compare)
 - [format](NumberUtils.md#format)
 - [getValueOrDefault](NumberUtils.md#getvalueordefault)
 - [getValueOrZero](NumberUtils.md#getvalueorzero)
 - [keepOnlyDecimalSeparator](NumberUtils.md#keeponlydecimalseparator)
 - [round](NumberUtils.md#round)
+- [safeFormat](NumberUtils.md#safeformat)
 - [stringToNumber](NumberUtils.md#stringtonumber)
 
 ## Constructors
@@ -60,13 +62,38 @@ Informo: "27.99"     | Obtenho: "27,99"
 
 #### Defined in
 
-src/utils/NumberUtils.ts:168
+src/utils/NumberUtils.ts:186
+
+___
+
+### compare
+
+▸ `Static` **compare**(`a`, `b`): `number`
+
+Determina a ordem de umeros.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `a` | `number` | Primeio número para comparação. |
+| `b` | `number` | Segundo número para comparação. |
+
+#### Returns
+
+`number`
+
+- Um numeral negativo se o primeiro argumento é menor que o segundo, zero se os dois são iguais e um numeral positivo quando o primeiro é maior que o segundo.
+
+#### Defined in
+
+src/utils/NumberUtils.ts:267
 
 ___
 
 ### format
 
-▸ `Static` **format**(`value`, `precision`, `prettyPrecision?`): `string`
+▸ `Static` **format**(`value`, `precision`, `prettyPrecision?`, `defaultValue?`): `string`
 
 Formata o numeral com a precisão informada.
 
@@ -74,6 +101,8 @@ Formata o numeral com a precisão informada.
 
 ```ts
 Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+Informado: (undefined, 3, 3) | Retorna: NaN
+Informado: (undefined, 3, 3, '0,00') | Retorna: 0,00
 ```
 
 #### Parameters
@@ -83,6 +112,7 @@ Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
 | `value` | `string` | `undefined` | Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##). |
 | `precision` | `number` | `undefined` | Quantidade de casas decimais. |
 | `prettyPrecision` | `number` | `NaN` | Quantidade de zeros nos decimais. |
+| `defaultValue` | `string` | `undefined` | Valor padrão caso o value não seja um valor numérico válido. |
 
 #### Returns
 
@@ -92,7 +122,7 @@ Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
 
 #### Defined in
 
-src/utils/NumberUtils.ts:74
+src/utils/NumberUtils.ts:77
 
 ___
 
@@ -135,7 +165,7 @@ Informo: value: "30abc", defaultValue: 0   | Obtenho: 0
 
 #### Defined in
 
-src/utils/NumberUtils.ts:190
+src/utils/NumberUtils.ts:208
 
 ___
 
@@ -159,7 +189,7 @@ Obtém o valor ou zero, caso o valor seja inválido(NaN/undefined).
 
 #### Defined in
 
-src/utils/NumberUtils.ts:209
+src/utils/NumberUtils.ts:227
 
 ___
 
@@ -190,7 +220,7 @@ Informado: '95.12' | Retorna: '9512'
 
 #### Defined in
 
-src/utils/NumberUtils.ts:140
+src/utils/NumberUtils.ts:158
 
 ___
 
@@ -234,7 +264,40 @@ Informo: ("100.16", 3)  |   100.16
 
 #### Defined in
 
-src/utils/NumberUtils.ts:237
+src/utils/NumberUtils.ts:255
+
+___
+
+### safeFormat
+
+▸ `Static` **safeFormat**(`value`, `precision`, `prettyPrecision?`): `string`
+
+Formata o numeral com a precisão informada e o valor default 0,00 caso o value não seja um numero valido.
+
+**`Example`**
+
+```ts
+Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+Informado: (undefined, 3, 3) | Retorna: 0,00
+```
+
+#### Parameters
+
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `value` | `string` | `undefined` | Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##). |
+| `precision` | `number` | `undefined` | Quantidade de casas decimais. |
+| `prettyPrecision` | `number` | `NaN` | Quantidade de zeros nos decimais. |
+
+#### Returns
+
+`string`
+
+- Numeral em formato de String formatado em PT-BR.
+
+#### Defined in
+
+src/utils/NumberUtils.ts:143
 
 ___
 

package/dist/utils/ArrayUtils.js

@@ -1,4 +1,5 @@
 import { StringUtils } from "./StringUtils.js";
+import { NumberUtils } from './NumberUtils.js';
 /**
  * `ArrayUtils`: Utilitário com a responsabilidade de manipular Arrays.
  */
@@ -39,7 +40,18 @@ export default class ArrayUtils {
      * @returns - Array ordenado alfabeticamente..
      */
     static sortAlphabetically(originalArray, fieldName = "label") {
-        return originalArray.sort((fieldA, fieldB) => StringUtils.compare(fieldA[fieldName], fieldB[fieldName]));
+        return originalArray.sort((fieldA, fieldB) => {
+            const valueStringA = fieldA[fieldName];
+            const valueStringB = fieldB[fieldName];
+            const valueIntA = NumberUtils.stringToNumber(valueStringA);
+            const valueIntB = NumberUtils.stringToNumber(valueStringB);
+            if (isNaN(valueIntA) || isNaN(valueIntB)) {
+                return StringUtils.compare(valueStringA, valueStringB);
+            }
+            else {
+                return NumberUtils.compare(valueIntA, valueIntB);
+            }
+        });
     }
 }
 //# sourceMappingURL=ArrayUtils.js.map

package/dist/utils/ArrayUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"ArrayUtils.js","sourceRoot":"","sources":["../../src/utils/ArrayUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC3B;;;;;;;;OAQG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAgB,EAAE,aAAyB,EAAE,sBAA+B,IAAI,EAAE,YAAoB,OAAO;QACnI,IAAG,CAAC,QAAQ,EAAC;YACR,OAAO,aAAa,CAAC;SACxB;QACD,MAAM,kBAAkB,GAAG,UAAU,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACtE,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAC9C,MAAM,SAAS,GAAW,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;YAC5E,OAAO,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,OAAO,mBAAmB,CAAC,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;IACzG,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,qBAAqB,CAAC,QAAe;QAChD,OAAO,WAAW,CAAC,kCAAkC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,aAAyB,EAAE,YAAoB,OAAO;QAC5E,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7G,CAAC;CACJ"}
+{"version":3,"file":"ArrayUtils.js","sourceRoot":"","sources":["../../src/utils/ArrayUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC3B;;;;;;;;OAQG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAgB,EAAE,aAAyB,EAAE,sBAA+B,IAAI,EAAE,YAAoB,OAAO;QACnI,IAAG,CAAC,QAAQ,EAAC;YACR,OAAO,aAAa,CAAC;SACxB;QACD,MAAM,kBAAkB,GAAG,UAAU,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACtE,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAC9C,MAAM,SAAS,GAAW,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;YAC5E,OAAO,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,OAAO,mBAAmB,CAAC,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;IACzG,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,qBAAqB,CAAC,QAAe;QAChD,OAAO,WAAW,CAAC,kCAAkC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,aAAyB,EAAE,YAAoB,OAAO;QAC5E,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;YAE3C,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YAEvC,MAAM,SAAS,GAAG,WAAW,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;YAC3D,MAAM,SAAS,GAAG,WAAW,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;YAE3D,IAAG,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAC;gBACtC,OAAO,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;aACvD;iBAAM;gBACL,OAAO,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;aAClD;QACH,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/utils/NumberUtils.d.ts

@@ -22,12 +22,28 @@ export declare class NumberUtils {
     * @param value - Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##).
     * @param precision - Quantidade de casas decimais.
     * @param prettyPrecision - Quantidade de zeros nos decimais.
+    * @param defaultValue - Valor padrão caso o value não seja um valor numérico válido.
     *
     * @returns - Numeral em formato de String formatado em PT-BR.
     * @example
     * Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+    * Informado: (undefined, 3, 3) | Retorna: NaN
+    * Informado: (undefined, 3, 3, '0,00') | Retorna: 0,00
     */
-    static format: (value: string, precision: number, prettyPrecision?: number) => string;
+    static format: (value: string, precision: number, prettyPrecision?: number, defaultValue?: string) => string;
+    /**
+    * Formata o numeral com a precisão informada e o valor default 0,00 caso o value não seja um numero valido.
+    *
+    * @param value - Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##).
+    * @param precision - Quantidade de casas decimais.
+    * @param prettyPrecision - Quantidade de zeros nos decimais.
+    *
+    * @returns - Numeral em formato de String formatado em PT-BR.
+    * @example
+    * Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+    * Informado: (undefined, 3, 3) | Retorna: 0,00
+    */
+    static safeFormat: (value: string, precision: number, prettyPrecision?: number) => string;
     /**
     * Retira os separadores de milhar de um numeral em formato de string.
     *
@@ -100,4 +116,12 @@ export declare class NumberUtils {
     * Informo: ("100.16", 3)  |   100.16
     */
     static round(value: number, decimals?: number): number;
+    /**
+    * Determina a ordem de umeros.
+    *
+    * @param a - Primeio número para comparação.
+    * @param b - Segundo número para comparação.
+    * @returns - Um numeral negativo se o primeiro argumento é menor que o segundo, zero se os dois são iguais e um numeral positivo quando o primeiro é maior que o segundo.
+    */
+    static compare(a: number, b: number): number;
 }

package/dist/utils/NumberUtils.js

@@ -32,6 +32,28 @@ export class NumberUtils {
         const multiplier = Math.pow(10, decimals);
         return Math.round(value * multiplier) / multiplier;
     }
+    /**
+    * Determina a ordem de umeros.
+    *
+    * @param a - Primeio número para comparação.
+    * @param b - Segundo número para comparação.
+    * @returns - Um numeral negativo se o primeiro argumento é menor que o segundo, zero se os dois são iguais e um numeral positivo quando o primeiro é maior que o segundo.
+    */
+    static compare(a, b) {
+        if (a === undefined) {
+            return b === undefined ? 0 : 1;
+        }
+        else if (b === undefined) {
+            return -1;
+        }
+        if (a === null) {
+            return b === null ? 0 : 1;
+        }
+        else if (b === null) {
+            return -1;
+        }
+        return a > b ? 1 : (a < b ? -1 : 0);
+    }
 }
 /**
 * Converte o dado numérico de string para number.
@@ -83,18 +105,21 @@ NumberUtils.stringToNumber = (value) => {
 * @param value - Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##).
 * @param precision - Quantidade de casas decimais.
 * @param prettyPrecision - Quantidade de zeros nos decimais.
+* @param defaultValue - Valor padrão caso o value não seja um valor numérico válido.
 *
 * @returns - Numeral em formato de String formatado em PT-BR.
 * @example
 * Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+* Informado: (undefined, 3, 3) | Retorna: NaN
+* Informado: (undefined, 3, 3, '0,00') | Retorna: 0,00
 */
-NumberUtils.format = (value, precision, prettyPrecision = NaN) => {
+NumberUtils.format = (value, precision, prettyPrecision = NaN, defaultValue = NaN.toString()) => {
     if (value === '' || value === undefined || value === "NaN") {
-        return NaN.toString();
+        return defaultValue;
     }
     const newValue = NumberUtils.stringToNumber(value);
     if (isNaN(newValue)) {
-        return NaN.toString();
+        return defaultValue;
     }
     //Validation "precision":
     // Case1: precision < 0 => does not use precision
@@ -131,6 +156,21 @@ NumberUtils.format = (value, precision, prettyPrecision = NaN) => {
     return newValueStr;
 };
 /**
+* Formata o numeral com a precisão informada e o valor default 0,00 caso o value não seja um numero valido.
+*
+* @param value - Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##).
+* @param precision - Quantidade de casas decimais.
+* @param prettyPrecision - Quantidade de zeros nos decimais.
+*
+* @returns - Numeral em formato de String formatado em PT-BR.
+* @example
+* Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+* Informado: (undefined, 3, 3) | Retorna: 0,00
+*/
+NumberUtils.safeFormat = (value, precision, prettyPrecision = NaN) => {
+    return NumberUtils.format(value, precision, prettyPrecision, "0,00");
+};
+/**
 * Retira os separadores de milhar de um numeral em formato de string.
 *
 * @param value - Numeral em formato de string a ser convertido.

package/dist/utils/NumberUtils.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sankhyalabs/core",
-  "version": "5.3.0",
+  "version": "5.4.1",
   "description": "Modulo core JavaScript da Sankhya.",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/utils/ArrayUtils.ts

@@ -1,4 +1,5 @@
 import { StringUtils } from "./StringUtils.js";
+import { NumberUtils } from './NumberUtils.js';
 
 /**
  * `ArrayUtils`: Utilitário com a responsabilidade de manipular Arrays.
@@ -37,11 +38,24 @@ export default class ArrayUtils {
 
     /**
      * Ordena valores de um array alfabeticamente.
-     * 
+     *
      * @param originalArray - Array a ser ordenado.
      * @returns - Array ordenado alfabeticamente..
      */
     static sortAlphabetically(originalArray: Array<any>, fieldName: string = "label"): Array<any>{
-        return originalArray.sort((fieldA, fieldB) => StringUtils.compare(fieldA[fieldName], fieldB[fieldName]));
+        return originalArray.sort((fieldA, fieldB) => {
+          
+          const valueStringA = fieldA[fieldName];
+          const valueStringB = fieldB[fieldName];
+          
+          const valueIntA = NumberUtils.stringToNumber(valueStringA);
+          const valueIntB = NumberUtils.stringToNumber(valueStringB);
+
+          if(isNaN(valueIntA) || isNaN(valueIntB)){
+            return StringUtils.compare(valueStringA, valueStringB)
+          } else {
+            return NumberUtils.compare(valueIntA, valueIntB);
+          }
+        });
     }
 }

package/src/utils/NumberUtils.ts

@@ -66,21 +66,24 @@ export class NumberUtils {
     * @param value - Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##).
     * @param precision - Quantidade de casas decimais.
     * @param prettyPrecision - Quantidade de zeros nos decimais.
+    * @param defaultValue - Valor padrão caso o value não seja um valor numérico válido.
     * 
     * @returns - Numeral em formato de String formatado em PT-BR.
     * @example
     * Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+    * Informado: (undefined, 3, 3) | Retorna: NaN
+    * Informado: (undefined, 3, 3, '0,00') | Retorna: 0,00
     */
-    static format = (value: string, precision: number, prettyPrecision: number = NaN): string => {
+    static format = (value: string, precision: number, prettyPrecision: number = NaN, defaultValue:string = NaN.toString()): string => {
 
         if (value === '' || value === undefined || value === "NaN") {
-            return NaN.toString();
+            return defaultValue;
         }
 
         const newValue: number = NumberUtils.stringToNumber(value);
 
         if (isNaN(newValue)) {
-            return NaN.toString();
+            return defaultValue;
         }
 
         //Validation "precision":
@@ -122,9 +125,24 @@ export class NumberUtils {
 
 
         return newValueStr;
+    }
 
 
-    }
+    /**
+    * Formata o numeral com a precisão informada e o valor default 0,00 caso o value não seja um numero valido.
+    * 
+    * @param value - Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##).
+    * @param precision - Quantidade de casas decimais.
+    * @param prettyPrecision - Quantidade de zeros nos decimais.
+    * 
+    * @returns - Numeral em formato de String formatado em PT-BR.
+    * @example
+    * Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+    * Informado: (undefined, 3, 3) | Retorna: 0,00
+    */
+     static safeFormat = (value: string, precision: number, prettyPrecision: number = NaN): string => {
+        return NumberUtils.format(value, precision, prettyPrecision, "0,00");
+     }
 
 
     /**
@@ -238,4 +256,28 @@ export class NumberUtils {
         const multiplier = 10 ** decimals;
         return Math.round(value * multiplier) / multiplier;
     }
+
+     /**
+     * Determina a ordem de umeros.
+     *
+     * @param a - Primeio número para comparação.
+     * @param b - Segundo número para comparação.
+     * @returns - Um numeral negativo se o primeiro argumento é menor que o segundo, zero se os dois são iguais e um numeral positivo quando o primeiro é maior que o segundo.
+     */
+    static compare(a: number, b: number): number{
+
+        if(a === undefined){
+            return b === undefined ? 0 : 1;
+        } else if(b === undefined){
+            return -1;
+        }
+
+        if(a === null){
+            return b === null ? 0 : 1;
+        } else if(b === null){
+            return -1;
+        }
+
+        return a > b ? 1 : (a < b ? -1 : 0);
+    }
 }