@sankhyalabs/core 0.0.0-hotfix-ga-KB-4098

package/dist/utils/ElementIDUtils.d.ts

@@ -0,0 +1,72 @@
+import DataUnit from "../dataunit/DataUnit.js";
+export interface IElementIDInfo {
+    id?: string;
+    dataUnit?: DataUnit;
+}
+/**
+ * `ElementIDUtils`: O ElementIDUtils é um utilitário responsável por criar e adicionar identificadores únicos aos componentes através do atributo data-element-id.
+ * A finalidade dele é otimizar a automação dos testes e melhorar a eficiência na manipulação dos componentes do Design System, garantindo seleções precisas e seguras.
+ */
+export declare class ElementIDUtils {
+    static DATA_ELEMENT_ID_ATTRIBUTE_NAME: string;
+    static INTERNAL_INPUT_NAME: string;
+    private static REGEX_DATAUNIT_NAME;
+    /**
+    * Cria e adiciona a propriedade `data-element-id` em um elemento.
+    *
+    * @param element - Elemento HTML a ser modificado (HTMLElement).
+    * @param suffix - Sufixo/Texto para ser adicionado.
+    * @param iDInfo - ID para ser adicionado.
+    * @returns - O data-element-id gerado.
+    */
+    static addIDInfo(element: HTMLElement, suffix?: string, iDInfo?: IElementIDInfo): string;
+    static addIDInfoIfNotExists(element: HTMLElement, suffix?: string, iDInfo?: IElementIDInfo): string;
+    static getInternalIDInfo(sufix: string): string;
+    /**
+    * Obtém o `data-element-id` do elemento com adição do sufixo e ID.
+    *
+    * @param element - Elemento HTML a ser modificado (HTMLElement).
+    * @param suffix - Sufixo/Texto para ser adicionado.
+    * @param iDInfo - ID para ser adicionado.
+    * @returns - Atributo `data-element-id` do elemento modificado com sufixo e/ou ID.
+    */
+    private static getDataElementID;
+    /**
+    * Obtém ID válido para o elemento.
+    *
+    * @param element - Elemento HTML a ser modificado (HTMLElement).
+    * @param iDInfo - ID para ser adicionado.
+    * @returns - ID para ser adicionado ao elemento conforme ordem de prioridade.
+    */
+    private static getAttributeValid;
+    /**
+    * Adiciona sufixo ao atributo `data-element-id` de um elemento, utilizado para montar a hierarquia dos ids dos componentes em tela.
+    *
+    * @param dataElementID - ID para ser adicionado ao `data-element-id`.
+    * @param suffix - Sufixo/Texto para ser adicionado ao `data-element-id`.
+    * @param element - Elemento HTML a ser modificado (HTMLElement).
+    * @returns - `data-element-id` com sufixo.
+    *
+    * @example
+    * Um ez-combo-box tem data-element-id = codparc_input_embedded_combo.
+    * Dentro desse ez-combo-box existe um ez-text-input. O data-element-id teria como sufixo o id 'codparc_input_embedded_combo' referente ao seu pai.
+    */
+    private static addSuffix;
+    /**
+    * Adiciona a propriedade name do DataUnit como prefixo do data-element-id do elemento.
+    *
+    * @param iDInfo - ID para ser adicionado ao `data-element-id`.
+    * @param dataElementID - Sufixo/Texto para ser adicionado ao `data-element-id`.
+    * @returns - String contendo informação para ser usada no `data-element-id` do elemento.
+    */
+    private static addPrefix;
+    /**
+    * Remove caracteres especiais.
+    *
+    * @param value - Texto que terá os caracteres especiais removidos.
+    * @returns - Retorna a string sem caracteres especiais e em camelCase.
+    */
+    private static formatDescription;
+    private static getDataElementIDAttribute;
+    private static parseDataUnitName;
+}

package/dist/utils/ElementIDUtils.js

@@ -0,0 +1,161 @@
+import { StringUtils } from "./StringUtils.js";
+/**
+ * `ElementIDUtils`: O ElementIDUtils é um utilitário responsável por criar e adicionar identificadores únicos aos componentes através do atributo data-element-id.
+ * A finalidade dele é otimizar a automação dos testes e melhorar a eficiência na manipulação dos componentes do Design System, garantindo seleções precisas e seguras.
+ */
+export class ElementIDUtils {
+    /**
+    * Cria e adiciona a propriedade `data-element-id` em um elemento.
+    *
+    * @param element - Elemento HTML a ser modificado (HTMLElement).
+    * @param suffix - Sufixo/Texto para ser adicionado.
+    * @param iDInfo - ID para ser adicionado.
+    * @returns - O data-element-id gerado.
+    */
+    static addIDInfo(element, suffix, iDInfo) {
+        try {
+            let dataElementID = this.getDataElementID(element, suffix, iDInfo);
+            dataElementID = StringUtils.replaceAccentuatedChars(dataElementID, false);
+            dataElementID = this.addPrefix(iDInfo, dataElementID);
+            element.setAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME, dataElementID);
+            return dataElementID;
+        }
+        catch (e) {
+            console.warn(`Erro ao gerar data-element-id: ${element.tagName}`, e);
+        }
+        return "";
+    }
+    static addIDInfoIfNotExists(element, suffix, iDInfo) {
+        try {
+            let dataElementID = element.getAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME);
+            if (dataElementID == undefined) {
+                dataElementID = ElementIDUtils.addIDInfo(element, suffix, iDInfo);
+            }
+            return dataElementID;
+        }
+        catch (e) {
+            console.warn(`Erro ao gerar data-element-id: ${element.tagName}`, e);
+        }
+        return "";
+    }
+    static getInternalIDInfo(sufix) {
+        return `${ElementIDUtils.INTERNAL_INPUT_NAME}_${sufix}`;
+    }
+    /**
+    * Obtém o `data-element-id` do elemento com adição do sufixo e ID.
+    *
+    * @param element - Elemento HTML a ser modificado (HTMLElement).
+    * @param suffix - Sufixo/Texto para ser adicionado.
+    * @param iDInfo - ID para ser adicionado.
+    * @returns - Atributo `data-element-id` do elemento modificado com sufixo e/ou ID.
+    */
+    static getDataElementID(element, suffix, iDInfo) {
+        let dataElementID = ElementIDUtils.getDataElementIDAttribute(element);
+        if (dataElementID != null) {
+            return this.addSuffix(StringUtils.toCamelCase(dataElementID), suffix, element);
+        }
+        const validAttribute = this.getAttributeValid(element, iDInfo);
+        if (validAttribute)
+            return this.addSuffix(validAttribute, suffix, element);
+        if (suffix)
+            return String(suffix);
+        let tagName = StringUtils.toCamelCase(element.tagName);
+        element.setAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME, tagName);
+        return tagName;
+    }
+    /**
+    * Obtém ID válido para o elemento.
+    *
+    * @param element - Elemento HTML a ser modificado (HTMLElement).
+    * @param iDInfo - ID para ser adicionado.
+    * @returns - ID para ser adicionado ao elemento conforme ordem de prioridade.
+    */
+    static getAttributeValid(element, iDInfo) {
+        if (iDInfo === null || iDInfo === void 0 ? void 0 : iDInfo.id) {
+            return this.formatDescription(iDInfo === null || iDInfo === void 0 ? void 0 : iDInfo.id);
+        }
+        if (element.hasAttribute("data-field-name")) {
+            return StringUtils.toCamelCase(element.getAttribute("data-field-name"));
+        }
+        if (element === null || element === void 0 ? void 0 : element.id) {
+            return StringUtils.toCamelCase(element === null || element === void 0 ? void 0 : element.id);
+        }
+        if (element.hasAttribute("name")) {
+            return this.formatDescription(element.getAttribute("name"));
+        }
+        if (element.hasAttribute("label")) {
+            return this.formatDescription(element.getAttribute("label"));
+        }
+        if (element.hasAttribute("title")) {
+            return this.formatDescription(element.getAttribute("title"));
+        }
+        return null;
+    }
+    /**
+    * Adiciona sufixo ao atributo `data-element-id` de um elemento, utilizado para montar a hierarquia dos ids dos componentes em tela.
+    *
+    * @param dataElementID - ID para ser adicionado ao `data-element-id`.
+    * @param suffix - Sufixo/Texto para ser adicionado ao `data-element-id`.
+    * @param element - Elemento HTML a ser modificado (HTMLElement).
+    * @returns - `data-element-id` com sufixo.
+    *
+    * @example
+    * Um ez-combo-box tem data-element-id = codparc_input_embedded_combo.
+    * Dentro desse ez-combo-box existe um ez-text-input. O data-element-id teria como sufixo o id 'codparc_input_embedded_combo' referente ao seu pai.
+    */
+    static addSuffix(dataElementID, suffix, element) {
+        if (suffix) {
+            return `${dataElementID}_${StringUtils.toCamelCase(suffix)}`;
+        }
+        if (StringUtils.isEmpty(dataElementID)) {
+            return `${StringUtils.toCamelCase(element.tagName)}`;
+        }
+        return `${dataElementID}_${StringUtils.toCamelCase(element.tagName)}`;
+    }
+    /**
+    * Adiciona a propriedade name do DataUnit como prefixo do data-element-id do elemento.
+    *
+    * @param iDInfo - ID para ser adicionado ao `data-element-id`.
+    * @param dataElementID - Sufixo/Texto para ser adicionado ao `data-element-id`.
+    * @returns - String contendo informação para ser usada no `data-element-id` do elemento.
+    */
+    static addPrefix(iDInfo, dataElementID) {
+        var _a;
+        let dataUnitName = ((_a = iDInfo === null || iDInfo === void 0 ? void 0 : iDInfo.dataUnit) === null || _a === void 0 ? void 0 : _a.name) || "";
+        dataUnitName = this.parseDataUnitName(dataUnitName);
+        if ((iDInfo === null || iDInfo === void 0 ? void 0 : iDInfo.dataUnit) && !(dataElementID === null || dataElementID === void 0 ? void 0 : dataElementID.startsWith(dataUnitName))) {
+            dataElementID = `${StringUtils.toCamelCase(dataUnitName)}_${dataElementID}`;
+        }
+        return dataElementID;
+    }
+    /**
+    * Remove caracteres especiais.
+    *
+    * @param value - Texto que terá os caracteres especiais removidos.
+    * @returns - Retorna a string sem caracteres especiais e em camelCase.
+    */
+    static formatDescription(value) {
+        if (!value)
+            return "";
+        value = StringUtils.replaceAccentuatedChars(value, false);
+        return StringUtils.toCamelCase((value.replace(/[^\w\sÀ-ÖØ-öø-ÿ]/gi, " ")).replace(/\s+/g, ' ').trim());
+    }
+    static getDataElementIDAttribute(element) {
+        if (element[ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME] || element.hasAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME)) {
+            return element[ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME] || element.getAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME);
+        }
+        return null;
+    }
+    static parseDataUnitName(uri) {
+        var _a;
+        if (StringUtils.isEmpty(uri)) {
+            return uri;
+        }
+        const matcher = this.REGEX_DATAUNIT_NAME.exec(uri);
+        return (_a = matcher === null || matcher === void 0 ? void 0 : matcher[1]) !== null && _a !== void 0 ? _a : uri;
+    }
+}
+ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME = "data-element-id";
+ElementIDUtils.INTERNAL_INPUT_NAME = "embedded";
+ElementIDUtils.REGEX_DATAUNIT_NAME = /dd:\/\/(.+?)\//;
+//# sourceMappingURL=ElementIDUtils.js.map

package/dist/utils/ElementIDUtils.js.map

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

package/dist/utils/JSUtils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Classe com utiliários comuns para funções genéricas em JavaScript.
+ */
+export declare class JSUtils {
+    /**
+     * Método responsável em criar um timer para processar uma determinada função.
+     *
+     * @param callback - Função de callback para processar após o timer.
+     * @param timeout - Valor dos milissegundos desejados para processar a função (o padrão é 300).
+     *
+     * @returns - Retorna um método com controle de timer para processar a função de callback.
+     */
+    static debounce(callback: any, timeout?: number): any;
+    /**
+     * Método responsável em validar se um elemento HTML está com o ellipsis ativo.
+     *
+     * @param element - Elemento HTML que será verificado.
+     *
+     * @returns - Retorna um valor booleando informando se o elemento está com o ellipsis ativo.
+     */
+    static isEllipsisActive(element: HTMLElement | any): boolean;
+    /**
+     * Método que verifica se uma string está encodada com base64.
+     *
+     * @param str - String que será verificada.
+     *
+     * @returns - Retorna um valor booleando informando se a string está encodada com base64.
+     */
+    static isBase64(str: string): boolean;
+    /**
+     * Método responsável em gerar um UUID.
+     *
+     * @returns - Retorna um UUID.
+    */
+    static generateUUID(): string;
+}

package/dist/utils/JSUtils.js

@@ -0,0 +1,66 @@
+import { v4 as uuid } from "uuid";
+/**
+ * Classe com utiliários comuns para funções genéricas em JavaScript.
+ */
+export class JSUtils {
+    /**
+     * Método responsável em criar um timer para processar uma determinada função.
+     *
+     * @param callback - Função de callback para processar após o timer.
+     * @param timeout - Valor dos milissegundos desejados para processar a função (o padrão é 300).
+     *
+     * @returns - Retorna um método com controle de timer para processar a função de callback.
+     */
+    static debounce(callback, timeout = 300) {
+        let timer;
+        return (...args) => {
+            clearTimeout(timer);
+            timer = setTimeout(() => { callback.apply(this, args); }, timeout);
+        };
+    }
+    /**
+     * Método responsável em validar se um elemento HTML está com o ellipsis ativo.
+     *
+     * @param element - Elemento HTML que será verificado.
+     *
+     * @returns - Retorna um valor booleando informando se o elemento está com o ellipsis ativo.
+     */
+    static isEllipsisActive(element) {
+        if (element == undefined) {
+            return false;
+        }
+        if (element.clientWidth < element.scrollWidth) {
+            const style = element.currentStyle || window.getComputedStyle(element);
+            return (style === null || style === void 0 ? void 0 : style.textOverflow) === 'ellipsis';
+        }
+        return false;
+    }
+    /**
+     * Método que verifica se uma string está encodada com base64.
+     *
+     * @param str - String que será verificada.
+     *
+     * @returns - Retorna um valor booleando informando se a string está encodada com base64.
+     */
+    static isBase64(str) {
+        str = (str || '').replaceAll("\n", "");
+        if (str === '' || str.trim() === '') {
+            return false;
+        }
+        try {
+            return window.btoa(window.atob(str)) == str;
+        }
+        catch (err) {
+            return false;
+        }
+    }
+    /**
+     * Método responsável em gerar um UUID.
+     *
+     * @returns - Retorna um UUID.
+    */
+    static generateUUID() {
+        return uuid();
+    }
+}
+//# sourceMappingURL=JSUtils.js.map

package/dist/utils/JSUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSUtils.js","sourceRoot":"","sources":["../../src/utils/JSUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAA;AAEjC;;GAEG;AACH,MAAM,OAAO,OAAO;IAElB;;;;;;;OAOG;IACI,MAAM,CAAC,QAAQ,CAAC,QAAa,EAAE,UAAkB,GAAG;QACvD,IAAI,KAAU,CAAC;QACf,OAAO,CAAC,GAAG,IAAS,EAAE,EAAE;YACtB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,gBAAgB,CAAC,OAA0B;QACvD,IAAI,OAAO,IAAI,SAAS,EAAE;YACxB,OAAO,KAAK,CAAC;SACd;QAED,IAAI,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE;YAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACvE,OAAO,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,YAAY,MAAK,UAAU,CAAC;SAC7C;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,QAAQ,CAAC,GAAW;QAChC,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAC;YAAE,OAAO,KAAK,CAAC;SAAE;QACrD,IAAI;YACA,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;SAC/C;QAAC,OAAO,GAAG,EAAE;YACV,OAAO,KAAK,CAAC;SAChB;IACH,CAAC;IAED;;;;MAIE;IACK,MAAM,CAAC,YAAY;QACxB,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;CACF"}

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>;
+}