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

package/dist/utils/DateUtils.js

@@ -0,0 +1,171 @@
+/**
+ * `DateUtils`: Utilizado para formatação, padronização e cálculos de datas.
+ */
+export default class DateUtils {
+    /**
+    * Zerar o horário de uma data.
+    *
+    * @param date - Data a ser manipulada.
+    * @param adjustDayLightSavingTime - Ajusta horário de verão na data recebida.
+    * @returns - Data sem as informações de horário.
+    * @example
+    * Informo: 2023-03-09 12:42:40      | Obtenho: 2023-03-09 00:00:00
+    */
+    static clearTime(date, adjustDayLightSavingTime = true) {
+        const newDate = new Date(date.getFullYear(), date.getMonth(), date.getDate(), 0, 0, 0, 0);
+        return adjustDayLightSavingTime ? DateUtils.adjustDLST(newDate) : newDate;
+    }
+    /**
+     * Converte data para uma string no formato pt-BR.
+     *
+     * @param date - Data a ser convertida.
+     * @param options - Opções de formatação da data.
+     * @returns - Uma string com a data no formato pt-BR DD/MM/YYYY.
+     */
+    static formatDate(date, options) {
+        return date ? new Intl.DateTimeFormat("pt-BR", options !== null && options !== void 0 ? options : {}).format(date) : "";
+    }
+    /**
+     * Converte as horas de uma data para uma string pt-BR.
+     *
+     * @param date - Data a ser convertida.
+     * @param showSeconds - define se devemos considerar os segundos.
+     * @returns - Uma string com as horas no formato HH:MM ou HH:MM:SS.
+     */
+    static formatTime(date, showSeconds = false) {
+        const timeOptions = { hour: "2-digit", minute: "2-digit", second: showSeconds ? "2-digit" : undefined };
+        return new Intl.DateTimeFormat("pt-BR", timeOptions).format(date);
+    }
+    /**
+     * Converte a data e hora para uma string no formato pt-BR.
+     *
+     * @param date - Data a ser convertida.
+     * @param showSeconds - define se devemos considerar os segundos.
+     * @returns - Uma string com as horas no formato DD/MM/YYYY HH:MM ou DD/MM/YYYY HH:MM:SS.
+     */
+    static formatDateTime(date, showSeconds = false) {
+        return `${DateUtils.formatDate(date)} ${DateUtils.formatTime(date, showSeconds)}`;
+    }
+    /**
+     * Converte String para Date.
+     *
+     * @param strValue - Texto a ser convertido para data.
+     * @param adjustDayLightSavingTime - Se verdadeiro, ativa regra de horário de verão.
+     * @param monthYearMode - Quando ativado, retorna o primeiro dia do mês apenas para construir a data.
+     * @returns - Data sem as informações de horário.
+     */
+    static strToDate(strValue, adjustDayLightSavingTime = true, monthYearMode = false) {
+        /** monthYearMode é um booleano para usar o formato MM/YYYY.
+         * Quando ativado, é retornado o primeiro dia do mês apenas para construir a data.
+         * Não há necessidade de verificar o horário de verão quando utilizado esse modo. */
+        let parts;
+        if (monthYearMode) {
+            parts = /^(1[0-2]|0[1-9]|[1-9])[^\d]?(\d{2}|\d{4})(?:\s(\d{1,2}):(\d{1,2}):?(\d{0,2}))?$/.exec(strValue);
+        }
+        else {
+            parts = /^(3[01]|[1-2]\d|0[1-9]|[1-9])[^\d]?(1[0-2]|0[1-9]|[1-9])[^\d]?(\d{2}|\d{4})(?:\s(\d{1,2}):(\d{1,2}):?(\d{0,2}))?$/.exec(strValue);
+        }
+        if (!parts) {
+            return undefined;
+        }
+        const day = monthYearMode ? 1 : Number(parts[1]);
+        const month = Number(parts[(monthYearMode ? 1 : 2)]);
+        let year = Number(parts[(monthYearMode ? 2 : 3)]);
+        const hour = Number(parts[(monthYearMode ? 3 : 4)] || 0);
+        const min = Number(parts[(monthYearMode ? 4 : 5)] || 0);
+        const sec = Number(parts[(monthYearMode ? 5 : 6)] || 0);
+        if (year < 100) {
+            year += year < 30 ? 2000 : 1900;
+        }
+        let date = new Date(year, month - 1, day, hour, min, sec, 0);
+        if (adjustDayLightSavingTime === true && !monthYearMode && hour == 0) {
+            date = DateUtils.adjustDLST(date);
+        }
+        return date;
+    }
+    /**
+     * Obtém a data atual.
+     *
+     * @param withTime - Caso true retorna a data com informações de horário.
+     * @returns - Data atual sem informação de horário.
+     */
+    static getToday(withTime = false) {
+        const today = new Date();
+        if (withTime) {
+            return today;
+        }
+        else {
+            return DateUtils.clearTime(today);
+        }
+    }
+    /**
+     * Retorna se a data é válida.
+     *
+     * @param value - Data a ser validada.
+     * @param hasTime - Determina se a data retornada deve conter informação de horário ou não. Por padrão não retorna a hora.
+     * @returns - Caso válida, retorna a própria data.
+     */
+    static validateDate(value, hasTime = false) {
+        return value instanceof Date && !isNaN(value.valueOf())
+            ? hasTime ? value : DateUtils.clearTime(value)
+            : undefined;
+    }
+    /**
+     * Realiza correção do horário de verão.
+     *
+     * @param date - Data a ser ajustada.
+     * @returns - Data informada ajustada para horário de verão.
+     */
+    static adjustDLST(date) {
+        if (date.getHours() == 23) {
+            return new Date(date.getFullYear(), date.getMonth(), date.getDate() + 1, 1, 0, 0, 0);
+        }
+        return date;
+    }
+    /**
+     * Adiciona uma casa decimal a esquerda de uma unidade.
+     *
+     * @param n - Número a ser ajustado
+     * @returns - O número informado, com uma casa decimal a esquerda.
+     * @example
+     * Informo: 15     | Obtenho: 15
+     * @example
+     * Informo:  2     | Obtenho: "02"
+     */
+    static pad(n) {
+        return n < 10 ? "0" + n : n;
+    }
+    /**
+     * Retorna timezone da data.
+     *
+     * @param offset - Valor do timezone desejado.
+     * @returns Timezone da data.
+     */
+    static timezoneOffset(offset) {
+        let sign;
+        if (offset === 0) {
+            return "Z";
+        }
+        sign = (offset > 0) ? "-" : "+";
+        offset = Math.abs(offset);
+        return sign + this.pad(Math.floor(offset / 60)) + ":" + this.pad(offset % 60);
+    }
+    /**
+     * Converte a data para o formato RFC3339.
+     *
+     * @param date - Data a ser convertida
+     * @returns - Data informada no formato RFC3339.
+     * * @example
+     * Informo: 2023-03-09 12:42:40     | Obtenho: 2023-03-09T12:42:47-03:00
+     */
+    static formatRfc3339(date) {
+        return date.getFullYear() + "-" +
+            this.pad(date.getMonth() + 1) + "-" +
+            this.pad(date.getDate()) + "T" +
+            this.pad(date.getHours()) + ":" +
+            this.pad(date.getMinutes()) + ":" +
+            this.pad(date.getSeconds()) +
+            this.timezoneOffset(date.getTimezoneOffset());
+    }
+}
+//# sourceMappingURL=DateUtils.js.map

package/dist/utils/DateUtils.js.map

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

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"}