@sankhyalabs/core 0.0.0-bugfix-dev-KB-6165.0

package/dist/utils/MaskFormatter.d.ts

@@ -0,0 +1,148 @@
+/**
+ * `MaskFormatter` é usado para formatar strings. Seu comportamento
+ * é controlado pelo formato do atributo `mask` que especifica quais
+ * caracteres são válidos e onde devem estar posicionados, intercalando-os
+ * com eventuais caracteres literais expressados no padrão informado.
+ * Sua implementação é inspirada pela implementação em Java do [MaskFormatter](https://docs.oracle.com/javase/7/docs/api/javax/swing/text/MaskFormatter.html).
+ *
+ * Para o padrão da máscara podem ser usados os seguintes caracteres especiais:
+ *
+ * | Caractere | Comportamento                                                                                               |
+ * |:---------:|-------------------------------------------------------------------------------------------------------------|
+ * | #         | Qualquer número                                                                                             |
+ * | '         | "Escapa" o caractere que vem na sequência. Útil quando desejamos converter um caractere especial em literal.|
+ * | U         | Qualquer letra. Transforma letras minúsculas em maiúsculas.                                                 |
+ * | L         | Qualquer letra. Transforma letras maiúsculas em minúsculas.                                                 |
+ * | A         | Qualquer letra ou número.                                                                                   |
+ * | ?         | Qualquer letra. Preserva maiúsculas e minúsculas.                                                           |
+ * | *         | Qualquer caractere.                                                                                         |
+ *
+ * Os demais caracteres presentes no padrão serão tratados como literais, isto é,
+ * serão apenas inseridos naquela posição.
+ *
+ * Quando o valor a ser formatado é menor que a máscara, um 'placeHolder'
+ * será inserido em cada posição ausente, completando a formatação.
+ * Por padrão será usado um espaço em branco como 'placeHolder', mas
+ * esse valor pode ser alterado.
+ *
+ * Por exemplo:
+ * '''
+ *    const formatter: MaskFormatter = new MaskFormatter("###-####");
+ *    formatter.placeholder = '_';
+ *    console.log(formatter.format("123"));
+ * '''
+ * resultaria na string '123-____'.
+ *
+ * ##Veja mais alguns exemplos:
+ * |Padrão          |Máscara           |Entrada       |Saída             |
+ * |----------------|------------------|--------------|------------------|
+ * |Telefone        |(##) ####-####    |3432192515    |(34) 3219-2515    |
+ * |CPF             |###.###.###-##    |12345678901   |123.456.789-01    |
+ * |CNPJ            |##.###.###/####-##|12345678901234|12.345.678/9012-34|
+ * |CEP             |##.###-###        |12345678      |12.345-678        |
+ * |PLACA (veículo) |UUU-####          |abc1234       |ABC-1234          |
+ * |Cor RGB         |'#AAAAAA          |00000F0       |#0000F0           |
+ *
+ */
+export declare class MaskFormatter {
+    private static DIGIT_KEY;
+    private static LITERAL_KEY;
+    private static UPPERCASE_KEY;
+    private static LOWERCASE_KEY;
+    private static ALPHA_NUMERIC_KEY;
+    private static CHARACTER_KEY;
+    private static ANYTHING_KEY;
+    static DEFAULT_MASKS: any;
+    private _mask;
+    private _maskChars;
+    /**
+     * Determina qual caractere será usado dos caracteres não presentes no valor,
+     * ou seja, aqueles que o usuário ainda não informou. Por padrão usamos um espaço.
+     */
+    placeholder: string;
+    /**
+     * Setter para mask. Trata-se do padrão que se espera ao formatar o texto.
+     */
+    set mask(mask: string);
+    /**
+     * Getter para mask.
+     *
+     * @return A última máscara informada.
+     */
+    get mask(): string;
+    constructor(mask: string);
+    /**
+     * Formata a string passada baseada na máscara definda pelo atributo mask.
+     *
+     * @param value Valor a ser formatado.
+     * @return O valor processado de acordo com o padrão.
+     */
+    format(value: string): string;
+    /**
+     * Prepara a formatação internamente de acordo com o padrão.
+     */
+    private updateInternalMask;
+    static MaskCharacter: {
+        new (maskFormatter: MaskFormatter, type: string): {
+            maskFormatter: MaskFormatter;
+            type: string;
+            /**
+             * Cada subclasse deve sobrescrever retornando true caso represente.
+             * um caractere literal. Por padrão o retorno é false.
+             */
+            isLiteral(): boolean;
+            /**
+             * Retorna se é um texto válido.
+             *
+             * @param aChar - Valor a ser validado.
+             * @returns - Retorna se é um texto válido.
+             */
+            isValidCharacter(aChar: string): boolean;
+            /**
+             * Retorna o texto informado.
+             *
+             * @param aChar - Texto a ser retornado.
+             * @returns - Texto informado.
+             */
+            getChar(aChar: string): string;
+            /**
+             * Adiciona valor encontrado.
+             *
+             * @param result - String a ser manipulada.
+             * @param formatting - String de formatação a ser adicionada na result.
+             * @param index - Índice que será utilizado para buscar no parâmetro formatting.
+             *
+             * @returns - Valor passado na result incrementado com o valor encontrado na formatting.
+             *
+             * @example
+             * ```  const result = "";
+             *       const formatting = "123456";
+             *       const index = [0];
+             *       const returnedResult = append(result, formatting, index);
+             *   ```
+             *   Retorna:
+             *   ```returnedResult = "1";
+             *      index = [1];
+             *   ```
+             */
+            append(result: string, formatting: string, index: Array<number>): string;
+            /**
+             * Obtém tipo por extenso.
+             *
+             * @returns O tipo por extenso.
+             * @example
+             * Se o tipo for **ALPHA_NUMERIC_KEY** recebo **uma letra ou um número**
+             */
+            getFormatMessage(): string;
+        };
+    };
+    private static LiteralCharacter;
+    private static DigitMaskCharacter;
+    private static UpperCaseCharacter;
+    private static LowerCaseCharacter;
+    private static AlphaNumericCharacter;
+    private static CharCharacter;
+}
+export declare namespace MaskFormatter {
+    type MaskCharacter = InstanceType<typeof MaskFormatter.MaskCharacter>;
+}

package/dist/utils/MaskFormatter.js

@@ -0,0 +1,356 @@
+/**
+ * `MaskFormatter` é usado para formatar strings. Seu comportamento
+ * é controlado pelo formato do atributo `mask` que especifica quais
+ * caracteres são válidos e onde devem estar posicionados, intercalando-os
+ * com eventuais caracteres literais expressados no padrão informado.
+ * Sua implementação é inspirada pela implementação em Java do [MaskFormatter](https://docs.oracle.com/javase/7/docs/api/javax/swing/text/MaskFormatter.html).
+ *
+ * Para o padrão da máscara podem ser usados os seguintes caracteres especiais:
+ *
+ * | Caractere | Comportamento                                                                                               |
+ * |:---------:|-------------------------------------------------------------------------------------------------------------|
+ * | #         | Qualquer número                                                                                             |
+ * | '         | "Escapa" o caractere que vem na sequência. Útil quando desejamos converter um caractere especial em literal.|
+ * | U         | Qualquer letra. Transforma letras minúsculas em maiúsculas.                                                 |
+ * | L         | Qualquer letra. Transforma letras maiúsculas em minúsculas.                                                 |
+ * | A         | Qualquer letra ou número.                                                                                   |
+ * | ?         | Qualquer letra. Preserva maiúsculas e minúsculas.                                                           |
+ * | *         | Qualquer caractere.                                                                                         |
+ *
+ * Os demais caracteres presentes no padrão serão tratados como literais, isto é,
+ * serão apenas inseridos naquela posição.
+ *
+ * Quando o valor a ser formatado é menor que a máscara, um 'placeHolder'
+ * será inserido em cada posição ausente, completando a formatação.
+ * Por padrão será usado um espaço em branco como 'placeHolder', mas
+ * esse valor pode ser alterado.
+ *
+ * Por exemplo:
+ * '''
+ *    const formatter: MaskFormatter = new MaskFormatter("###-####");
+ *    formatter.placeholder = '_';
+ *    console.log(formatter.format("123"));
+ * '''
+ * resultaria na string '123-____'.
+ *
+ * ##Veja mais alguns exemplos:
+ * |Padrão          |Máscara           |Entrada       |Saída             |
+ * |----------------|------------------|--------------|------------------|
+ * |Telefone        |(##) ####-####    |3432192515    |(34) 3219-2515    |
+ * |CPF             |###.###.###-##    |12345678901   |123.456.789-01    |
+ * |CNPJ            |##.###.###/####-##|12345678901234|12.345.678/9012-34|
+ * |CEP             |##.###-###        |12345678      |12.345-678        |
+ * |PLACA (veículo) |UUU-####          |abc1234       |ABC-1234          |
+ * |Cor RGB         |'#AAAAAA          |00000F0       |#0000F0           |
+ *
+ */
+export class MaskFormatter {
+    /**
+     * Setter para mask. Trata-se do padrão que se espera ao formatar o texto.
+     */
+    set mask(mask) {
+        this._mask = mask;
+        this.updateInternalMask();
+    }
+    /**
+     * Getter para mask.
+     *
+     * @return A última máscara informada.
+     */
+    get mask() {
+        return this._mask;
+    }
+    constructor(mask) {
+        this._mask = '';
+        this._maskChars = new Array();
+        /**
+         * Determina qual caractere será usado dos caracteres não presentes no valor,
+         * ou seja, aqueles que o usuário ainda não informou. Por padrão usamos um espaço.
+         */
+        this.placeholder = ' ';
+        this.mask = mask;
+    }
+    /**
+     * Formata a string passada baseada na máscara definda pelo atributo mask.
+     *
+     * @param value Valor a ser formatado.
+     * @return O valor processado de acordo com o padrão.
+     */
+    format(value) {
+        let result = '';
+        const index = [0];
+        let counter = 0;
+        const maxCounter = this._maskChars.length;
+        while (counter < maxCounter) {
+            result = this._maskChars[counter].append(result, value, index);
+            counter++;
+        }
+        return result;
+    }
+    /**
+     * Prepara a formatação internamente de acordo com o padrão.
+     */
+    updateInternalMask() {
+        this._maskChars.length = 0;
+        if (this.mask != null) {
+            let counter = 0;
+            const maxCounter = this.mask.length;
+            while (counter < maxCounter) {
+                let maskChar = this.mask.charAt(counter);
+                switch (maskChar) {
+                    case MaskFormatter.DIGIT_KEY:
+                        this._maskChars.push(new MaskFormatter.DigitMaskCharacter(this, maskChar));
+                        break;
+                    case MaskFormatter.LITERAL_KEY:
+                        if (++counter < maxCounter) {
+                            maskChar = this.mask.charAt(counter);
+                            this._maskChars.push(new MaskFormatter.LiteralCharacter(this, maskChar));
+                        }
+                        break;
+                    case MaskFormatter.UPPERCASE_KEY:
+                        this._maskChars.push(new MaskFormatter.UpperCaseCharacter(this, maskChar));
+                        break;
+                    case MaskFormatter.LOWERCASE_KEY:
+                        this._maskChars.push(new MaskFormatter.LowerCaseCharacter(this, maskChar));
+                        break;
+                    case MaskFormatter.ALPHA_NUMERIC_KEY:
+                        this._maskChars.push(new MaskFormatter.AlphaNumericCharacter(this, maskChar));
+                        break;
+                    case MaskFormatter.CHARACTER_KEY:
+                        this._maskChars.push(new MaskFormatter.CharCharacter(this, maskChar));
+                        break;
+                    case MaskFormatter.ANYTHING_KEY:
+                        this._maskChars.push(new MaskFormatter.MaskCharacter(this, maskChar));
+                        break;
+                    default:
+                        this._maskChars.push(new MaskFormatter.LiteralCharacter(this, maskChar));
+                        break;
+                }
+                counter++;
+            }
+        }
+    }
+}
+MaskFormatter.DIGIT_KEY = "#";
+MaskFormatter.LITERAL_KEY = "'";
+MaskFormatter.UPPERCASE_KEY = "U";
+MaskFormatter.LOWERCASE_KEY = "L";
+MaskFormatter.ALPHA_NUMERIC_KEY = "A";
+MaskFormatter.CHARACTER_KEY = "?";
+MaskFormatter.ANYTHING_KEY = "*";
+MaskFormatter.DEFAULT_MASKS = {
+    "cnpj": "##.###.###/####-##",
+    "cpf": "###.###.###-##",
+    "phone": "(##) ####-####",
+    "cep": "##.###-###"
+};
+//
+// Classes internas usadas para representar a máscara.
+//
+MaskFormatter.MaskCharacter = class {
+    constructor(maskFormatter, type) {
+        this.maskFormatter = maskFormatter;
+        this.type = type;
+    }
+    /**
+     * Cada subclasse deve sobrescrever retornando true caso represente.
+     * um caractere literal. Por padrão o retorno é false.
+     */
+    isLiteral() {
+        return false;
+    }
+    /**
+     * Retorna se é um texto válido.
+     *
+     * @param aChar - Valor a ser validado.
+     * @returns - Retorna se é um texto válido.
+     */
+    isValidCharacter(aChar) {
+        if (this.isLiteral()) {
+            return (this.getChar(aChar) == aChar);
+        }
+        aChar = this.getChar(aChar);
+        return true;
+    }
+    /**
+     * Retorna o texto informado.
+     *
+     * @param aChar - Texto a ser retornado.
+     * @returns - Texto informado.
+     */
+    getChar(aChar) {
+        return aChar;
+    }
+    /**
+     * Adiciona valor encontrado.
+     *
+     * @param result - String a ser manipulada.
+     * @param formatting - String de formatação a ser adicionada na result.
+     * @param index - Índice que será utilizado para buscar no parâmetro formatting.
+     *
+     * @returns - Valor passado na result incrementado com o valor encontrado na formatting.
+     *
+     * @example
+     * ```  const result = "";
+     *       const formatting = "123456";
+     *       const index = [0];
+     *       const returnedResult = append(result, formatting, index);
+     *   ```
+     *   Retorna:
+     *   ```returnedResult = "1";
+     *      index = [1];
+     *   ```
+     */
+    append(result, formatting, index) {
+        const inString = index[0] < formatting.length;
+        const aChar = inString ? formatting.charAt(index[0]) : '';
+        if (this.isLiteral()) {
+            const literal = this.getChar(aChar);
+            result += literal;
+            if (literal === aChar) {
+                index[0] = index[0] + 1;
+            }
+        }
+        else if (index[0] >= formatting.length) {
+            result += this.maskFormatter.placeholder;
+            index[0] = index[0] + 1;
+        }
+        else if (this.isValidCharacter(aChar)) {
+            result += this.getChar(aChar);
+            index[0] = index[0] + 1;
+        }
+        else {
+            throw new Error(`Valor inválido: "${aChar}". Na posição ${index[0] + 1} espera-se ${this.getFormatMessage()}.`);
+        }
+        return result;
+    }
+    /**
+     * Obtém tipo por extenso.
+     *
+     * @returns O tipo por extenso.
+     * @example
+     * Se o tipo for **ALPHA_NUMERIC_KEY** recebo **uma letra ou um número**
+     */
+    getFormatMessage() {
+        let message;
+        switch (this.type) {
+            case MaskFormatter.UPPERCASE_KEY:
+            case MaskFormatter.LOWERCASE_KEY:
+            case MaskFormatter.CHARACTER_KEY:
+                message = 'uma letra';
+                break;
+            case MaskFormatter.DIGIT_KEY:
+                message = 'um número';
+                break;
+            case MaskFormatter.ALPHA_NUMERIC_KEY:
+                message = 'uma letra ou um número';
+                break;
+            default:
+                message = '';
+        }
+        return message;
+    }
+};
+MaskFormatter.LiteralCharacter = class extends MaskFormatter.MaskCharacter {
+    constructor(maskFormatter, fixedChar) {
+        super(maskFormatter, fixedChar);
+        this._fixedChar = fixedChar;
+    }
+    isLiteral() {
+        return true;
+    }
+    getChar(aChar) {
+        aChar;
+        return this._fixedChar;
+    }
+};
+MaskFormatter.DigitMaskCharacter = class extends MaskFormatter.MaskCharacter {
+    /**
+     * Valida se o caracter é válido.
+     *
+     * @param aChar - Caracter a ser validado.
+     * @returns - Se o caracter é valido ou não.
+     */
+    isValidCharacter(aChar) {
+        return (this.isDigit(aChar) && super.isValidCharacter(aChar));
+    }
+    /**
+     * Valida se é um numéro.
+     *
+     * @param char - String a ser verificada.
+     * @returns - Verdadeiro para caracteres numéricos.
+     *
+     * @example
+     * ```Informado: "8" | Retorno: true ```
+     * @example
+     * ```Informado: "A" | Retorno: false ```
+     */
+    isDigit(char) {
+        return char >= '0' && char <= '9';
+    }
+};
+MaskFormatter.UpperCaseCharacter = class extends MaskFormatter.MaskCharacter {
+    /**
+    * Valida se a string é uma letra do alfabeto (a-z).
+    *
+    * @param aChar - String passada para validação.
+    * @returns - Verdadeiro se a string passada for uma letra do alfabeto.
+    */
+    isValidCharacter(aChar) {
+        return (/[a-z]/i.test(aChar) && super.isValidCharacter(aChar));
+    }
+    /**
+    * Obtém a string passada em maiúscula.
+    *
+    * @param aChar - String passada para validação.
+    * @returns - O caracter passado em letra maiúscula.
+    */
+    getChar(aChar) {
+        return aChar.toUpperCase();
+    }
+};
+MaskFormatter.LowerCaseCharacter = class extends MaskFormatter.MaskCharacter {
+    /**
+    * Valida se a string é uma letra do alfabeto (a-z).
+    *
+    * @param aChar - String passada para validação.
+    * @returns - Verdadeiro se a string passada for uma letra do alfabeto.
+    */
+    isValidCharacter(aChar) {
+        return (/[a-z]/i.test(aChar) && super.isValidCharacter(aChar));
+    }
+    /**
+    * Obtém a string passada em minúscula.
+    *
+    * @param aChar - String passada para validação.
+    * @returns - O caracter passado em letra minúscula.
+    */
+    getChar(aChar) {
+        return aChar.toLocaleLowerCase();
+    }
+};
+MaskFormatter.AlphaNumericCharacter = class extends MaskFormatter.MaskCharacter {
+    /**
+    * Valida se a string é uma letra do alfabeto (a-z) ou um numero entre zero e nove.
+    *
+    * @param aChar - String passada para validação.
+    * @returns - Verdadeiro se a string passada for uma letra do alfabeto ou um numeral (de 0 a 9).
+    */
+    isValidCharacter(aChar) {
+        //FIXME: talvez seja problema usar regex aqui... avaliar se existe forma mais barata.
+        return (/[a-z0-9]/i.test(aChar)) && super.isValidCharacter(aChar);
+    }
+};
+MaskFormatter.CharCharacter = class extends MaskFormatter.MaskCharacter {
+    /**
+    * Valida se a string é uma letra do alfabeto (a-z).
+    *
+    * @param aChar - String passada para validação.
+    * @returns - Verdadeiro se a string passada for uma letra do alfabeto.
+    */
+    isValidCharacter(aChar) {
+        //FIXME: talvez seja problema usar regex aqui... avaliar se existe forma mais barata
+        return (/[a-z]/i.test(aChar) && super.isValidCharacter(aChar));
+    }
+};
+//# sourceMappingURL=MaskFormatter.js.map

package/dist/utils/MaskFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaskFormatter.js","sourceRoot":"","sources":["../../src/utils/MaskFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,OAAO,aAAa;IA2BtB;;OAEG;IACH,IAAW,IAAI,CAAC,IAAY;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,YAAY,IAAY;QA1BhB,UAAK,GAAW,EAAE,CAAC;QACnB,eAAU,GAAuC,IAAI,KAAK,EAA+B,CAAC;QAElG;;;WAGG;QACI,gBAAW,GAAW,GAAG,CAAC;QAoB7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAa;QACvB,IAAI,MAAM,GAAW,EAAE,CAAC;QACxB,MAAM,KAAK,GAAkB,CAAC,CAAC,CAAC,CAAC;QAEjC,IAAI,OAAO,GAAW,CAAC,CAAC;QACxB,MAAM,UAAU,GAAW,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAClD,OAAO,OAAO,GAAG,UAAU,EAAE;YACzB,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC/D,OAAO,EAAE,CAAC;SACb;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,kBAAkB;QAEtB,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAE3B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE;YACnB,IAAI,OAAO,GAAW,CAAC,CAAC;YACxB,MAAM,UAAU,GAAW,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5C,OAAO,OAAO,GAAG,UAAU,EAAE;gBAEzB,IAAI,QAAQ,GAAW,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAEjD,QAAQ,QAAQ,EAAE;oBACd,KAAK,aAAa,CAAC,SAAS;wBACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;wBAC3E,MAAM;oBACV,KAAK,aAAa,CAAC,WAAW;wBAC1B,IAAI,EAAE,OAAO,GAAG,UAAU,EAAE;4BACxB,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;4BACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;yBAC5E;wBACD,MAAM;oBACV,KAAK,aAAa,CAAC,aAAa;wBAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;wBAC3E,MAAM;oBACV,KAAK,aAAa,CAAC,aAAa;wBAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;wBAC3E,MAAM;oBACV,KAAK,aAAa,CAAC,iBAAiB;wBAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;wBAC9E,MAAM;oBACV,KAAK,aAAa,CAAC,aAAa;wBAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;wBACtE,MAAM;oBACV,KAAK,aAAa,CAAC,YAAY;wBAC3B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;wBACtE,MAAM;oBACV;wBACI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;wBACzE,MAAM;iBACb;gBACD,OAAO,EAAE,CAAC;aACb;SACJ;IACL,CAAC;;AAhHc,uBAAS,GAAW,GAAG,CAAC;AACxB,yBAAW,GAAW,GAAG,CAAC;AAC1B,2BAAa,GAAW,GAAG,CAAC;AAC5B,2BAAa,GAAW,GAAG,CAAC;AAC5B,+BAAiB,GAAW,GAAG,CAAC;AAChC,2BAAa,GAAW,GAAG,CAAC;AAC5B,0BAAY,GAAW,GAAG,CAAC;AAE5B,2BAAa,GAAQ;IAC/B,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE,gBAAgB;IACvB,OAAO,EAAE,gBAAgB;IACzB,KAAK,EAAE,YAAY;CACtB,CAAC;AAqGF,EAAE;AACF,sDAAsD;AACtD,EAAE;AACY,2BAAa,GAAG;IAK1B,YAAY,aAA4B,EAAE,IAAY;QAClD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IACD;;;OAGG;IACI,SAAS;QACZ,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACI,gBAAgB,CAAC,KAAa;QACjC,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE;YAClB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;SACzC;QAED,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE5B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,KAAa;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACI,MAAM,CAAC,MAAc,EAAE,UAAkB,EAAE,KAAoB;QAElE,MAAM,QAAQ,GAAY,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;QACvD,MAAM,KAAK,GAAW,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAElE,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE;YAClB,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,IAAI,OAAO,CAAC;YAClB,IAAG,OAAO,KAAK,KAAK,EAAC;gBAClB,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;aAC1B;SACJ;aAAM,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE;YACtC,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC;YACzC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;SAC3B;aAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE;YACrC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;SAC3B;aAAM;YACH,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,iBAAiB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;SACnH;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACI,gBAAgB;QACnB,IAAI,OAAe,CAAC;QACpB,QAAO,IAAI,CAAC,IAAI,EAAC;YACb,KAAK,aAAa,CAAC,aAAa,CAAC;YACjC,KAAK,aAAa,CAAC,aAAa,CAAC;YACjC,KAAK,aAAa,CAAC,aAAa;gBAC5B,OAAO,GAAG,WAAW,CAAC;gBACtB,MAAM;YACV,KAAK,aAAa,CAAC,SAAS;gBACxB,OAAO,GAAG,WAAW,CAAC;gBACtB,MAAM;YACV,KAAK,aAAa,CAAC,iBAAiB;gBAChC,OAAO,GAAG,wBAAwB,CAAC;gBACnC,MAAM;YACV;gBACI,OAAO,GAAG,EAAE,CAAA;SACnB;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ,CAAA;AAEc,8BAAgB,GAAG,KAAM,SAAQ,aAAa,CAAC,aAAa;IAIvE,YAAY,aAA4B,EAAE,SAAiB;QACvD,KAAK,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IAEM,SAAS;QACZ,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,OAAO,CAAC,KAAa;QACxB,KAAK,CAAC;QACN,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;CACJ,CAAA;AAEc,gCAAkB,GAAG,KAAM,SAAQ,aAAa,CAAC,aAAa;IAEzE;;;;;OAKG;IACI,gBAAgB,CAAC,KAAa;QACjC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACK,OAAO,CAAC,IAAY;QACxB,OAAO,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAA;IACrC,CAAC;CACJ,CAAA;AAGc,gCAAkB,GAAG,KAAM,SAAQ,aAAa,CAAC,aAAa;IAEzE;;;;;MAKE;IACK,gBAAgB,CAAC,KAAa;QACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;MAKE;IACK,OAAO,CAAC,KAAa;QACxB,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC;CACJ,CAAA;AAEc,gCAAkB,GAAG,KAAM,SAAQ,aAAa,CAAC,aAAa;IAEzE;;;;;MAKE;IACK,gBAAgB,CAAC,KAAa;QACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;MAKE;IACK,OAAO,CAAC,KAAa;QACxB,OAAO,KAAK,CAAC,iBAAiB,EAAE,CAAC;IACrC,CAAC;CACJ,CAAA;AAEc,mCAAqB,GAAG,KAAM,SAAQ,aAAa,CAAC,aAAa;IAE5E;;;;;MAKE;IACK,gBAAgB,CAAC,KAAa;QACjC,qFAAqF;QACrF,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;CACJ,CAAA;AAEc,2BAAa,GAAG,KAAM,SAAQ,aAAa,CAAC,aAAa;IACpE;;;;;MAKE;IACK,gBAAgB,CAAC,KAAa;QACjC,oFAAoF;QACpF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;CAEJ,CAAA"}

package/dist/utils/NumberUtils.d.ts

@@ -0,0 +1,127 @@
+/**
+ * `NumberUtils`: Utilizado para manipulação de numerais.
+ */
+export declare class NumberUtils {
+    /**
+    * Converte o dado numérico de string para number.
+    *
+    * @param value Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico: ######.##).
+    * @returns - Numeral passado.
+    * @example
+    * @"100,12"     |       100.12
+    * @"100.12"     |       100.12
+    * @"-100,12"    |       -100.12
+    * @"R$100,12"   |       100.12
+    * @"-R$100,12"  |       -100.12
+    * @"string"     |       NaN
+    */
+    static stringToNumber: (value: string) => number;
+    /**
+    * Formata o numeral com a precisão informada.
+    *
+    * @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, 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.
+    *
+    * @param value - Numeral em formato de string a ser convertido.
+    * @param formatnumber - Formatação de ENTRADA e SAÍDA do utilitário: pt-BR="###.###,##" en-US="###,###.##"; Default: "pt-BR".
+    *
+    * @returns - Numeral em formato de string formatado apenas com separador decimal.
+    * @example
+    * Informado: '95.12' | Retorna: '9512'
+    */
+    static keepOnlyDecimalSeparator: (value: string, formatnumber?: string) => string;
+    /**
+    * Troca o formato do numeral(string) de "PT-BR" para "EN-US" e vice-versa.
+    *
+    * @param value - Numeral em formato de string a ser convertido.
+    *
+    * @returns - Numeral em formato de string formatado de "PT-BR" para "EN-US" e vice-versa.
+    * @example
+    * Informo: "15,55"     | Obtenho: "15.55"
+    * @example
+    * Informo: "27.99"     | Obtenho: "27,99"
+    */
+    static changeFormat: (value: string) => string;
+    /**
+    * Obtém o valor ou o valor padrão, caso o valor seja inválido(NaN/undefined).
+    *
+    * @param value - Valor a ser validado.
+    * @param defaultValue - Valor padrão a ser retornado caso o value seja inválido.
+    *
+    * @returns - O próprio numeral passado ou zero.
+    *
+    * @example
+    * Informo: value: 30, defaultValue: 0     | Obtenho: 30
+    * @example
+    * Informo: value: "30", defaultValue: 0   | Obtenho: 30
+    * @example
+    * Informo: value: "30abc", defaultValue: 0   | Obtenho: 0
+    */
+    static getValueOrDefault: (value: any, defaultValue: number) => number;
+    /**
+    * Obtém o valor ou zero, caso o valor seja inválido(NaN/undefined).
+    *
+    * @param value - Numeral a ser validado.
+    *
+    * @returns - O próprio numeral passado. Caso esse seja inválido retorna zero.
+    */
+    static getValueOrZero: (value: any) => number;
+    /**
+    * Realiza o arredondamento de casas decimais de um numero.
+    *
+    * @param value - Numeral a ser arredondado.
+    * @param decimals - Quantidade de casas decimais ussada no arredondamento.
+    *
+    * @returns - O próprio numeral arredondado com a quantidade de casas decimais do argumento decimals.
+    *
+    * @example
+    * Informo: (100.12)       |   100.12
+    * Informo: (100,12)       |   NaN
+    
+    * Informo: ("100.12", 1)  |   100.1
+    * Informo: ("100.12", 2)  |   100.12
+    * Informo: ("100.12", 3)  |   100.12
+    
+    * Informo: ("100.15", 1)  |   100.2
+    * Informo: ("100.15", 2)  |   100.15
+    * Informo: ("100.15", 3)  |   100.15
+    
+    * Informo: ("100.16", 1)  |   100.2
+    * Informo: ("100.16", 2)  |   100.16
+    * 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;
+}