@sankhyalabs/core 5.11.6 → 5.12.0-dev.1

package/src/utils/KeyboardManager/types/key-code-events.ts

@@ -0,0 +1,15 @@
+export type KeyCodeEvent = {
+  key: string
+  keyCode: number
+  which: number
+  code?: string
+  location?: number
+  description?: string
+  unicode?: string
+  altKey?: boolean
+  ctrlKey?: boolean
+  metaKey?: boolean
+  shiftKey?: boolean
+  repeat?: boolean
+  path?: string
+}

package/src/utils/KeyboardManager/types/meta-keys.ts

@@ -0,0 +1 @@
+export type MetaKeys = 'meta' | 'shift' | 'alt' | 'ctrl'

package/src/utils/StringUtils.ts

@@ -8,10 +8,10 @@ export class StringUtils {
     /**
      * Retorna se a string está vazia.
      * Valores null e undefined são considerados como vazio.
-     * 
+     *
      * @param value - String para ser validada.
      * @returns - Verdadeiro caso a string não contenha informação.
-     * 
+     *
     */
     static isEmpty(value: any): Boolean {
 
@@ -28,10 +28,10 @@ export class StringUtils {
 
         return false;
     }
-    
+
     /**
      * Remove acentos de vogais maiúsculas
-     * 
+     *
      * @param text  String para ser transformada.
      * @example entrada: "ÁÊÇÒ" // retorno: "AECO"
     */
@@ -53,7 +53,7 @@ export class StringUtils {
 
     /**
      * Converte todas as entidades HTML de um texto
-     * 
+     *
      * @param text  String para ser transformada.
      * @example entrada: "&lt;Teste&gt;" // retorno: "<Teste>"
     */
@@ -77,20 +77,20 @@ export class StringUtils {
         for(const entity of entities) {
             text = text.replace(new RegExp(`&${entity[0]};`), entity[1]);
         }
-    
+
         return text;
       }
 
     /**
      * Remove acentos de vogais minúsculas.
-     * 
+     *
      * @param text  String para ser transformada.
      * @example entrada: "áêçò" // retorno: "aeco"
-    */   
+    */
     static replaceAccentuatedCharsLower(text: string): string {
         if(!text.replace){
             return text;
-        }        
+        }
         return text.replace(/[àáâãäåæ]/g, 'a')
         .replace(/[èéêë]/g, 'e')
         .replace(/[ìíîï]/g, 'i')
@@ -103,10 +103,10 @@ export class StringUtils {
 
     /**
      * Remove acentuação de vogais e de caracteres especiais que não sejam letras ou numeral.
-     * 
+     *
      * @param text                  String para ser transformada.
      * @param removeSpecialChars    Remove outros caracteres especiais que não sejam letras e números.
-     * @example 
+     * @example
      * entrada: "á@Êç#Ò", false // retorno: "a@Ec#O"
      * entrada: "á@Êç#Ò", true // retorno: "aEcO"
     */
@@ -114,7 +114,7 @@ export class StringUtils {
         if(!text.replace){
             return text;
         }
-        
+
         text = StringUtils.replaceAccentuatedCharsLower(text);
         text = StringUtils.replaceAccentuatedCharsUpper(text);
 
@@ -151,9 +151,9 @@ export class StringUtils {
         return hash.toString();
     }
 
-    /** 
+    /**
      * Converte um texto do tipo string para um booleano.
-     * 
+     *
      * @param value Valor a ser convertido.
      * @param defaultValue Valor padrão.
      * @returns - Texto convertido.
@@ -174,21 +174,21 @@ export class StringUtils {
     }
 
     /**
-     * 
+     *
      * Adiciona caracteres à esquerda caso texto seja menor que o valor do parâmetro len passado.
-     * 
+     *
      * @param str - Texto para ser ajustado.
      * @param len - Tamanho desejado do texto.
      * @param pad - Caractere a ser adicionado a esquerda caso o texto menor que o tamanho passado.
      * @returns - Texto passado se este for maior que o len.
      * Ou retorna o texto com os caracteres adicionados na esquerda.
-     * 
+     *
      * @example
      * padStart('SANKHYA', 8,'.') | Retorna: '...SANKHYA'
      * @example
      * padStart('SANKHYA', 5,'A') | Retorna: 'SANKHYA'
-     * 
-     * 
+     *
+     *
     */
     static padStart(str: string, len: number, pad: string = " "): string {
         str = str != undefined ? str : "";
@@ -199,21 +199,21 @@ export class StringUtils {
     }
 
     /**
-     * 
+     *
      * Adiciona caracteres à direita caso texto seja menor que o valor do parâmetro len passado.
-     * 
+     *
      * @param str - Texto para ser ajustado.
      * @param len - Tamanho desejado do texto.
      * @param pad - Caractere a ser adicionado a direita caso o texto menor que o tamanho passado.
      * @returns - Texto passado se este for maior que o len.
      * Ou retorna o texto com os caracteres adicionados na direita.
-     * 
+     *
      * @example
      * padStart('SANKHYA', 8,'.') | Retorna: 'SANKHYA...'
      * @example
      * padStart('SANKHYA', 5,'A') | Retorna: 'SANKHYA'
-     * 
-     * 
+     *
+     *
     */
     static padEnd(str: string, len: number, pad: string = " "): string {
         str = str != undefined ? str : "";
@@ -232,7 +232,7 @@ export class StringUtils {
      * @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: string, b: string): number{
-        
+
         if(a === undefined){
             return b === undefined ? 0 : 1;
         } else if(b === undefined){
@@ -247,24 +247,24 @@ export class StringUtils {
 
         return a.localeCompare(b);
     }
-  
+
     /**
      * Converte string em camelCase.
      * Combina palavras compostas ou frases, alterando a inicial de cada uma, a partir da primeira, para maiúscula e unidas sem espaços.
      * @param value String a ser convertida.
-     * @returns String convertida em camelCase. 
-     * 
+     * @returns String convertida em camelCase.
+     *
      * @example
      * toCamelCase('Exemplo de uso') | Retorna: 'exemploDeUso'
      */
     static toCamelCase(value: string): string {
         if(!value) return "";
-        if (value.match(/^[a-z]+[A-Z]/) || value.includes(".")) { 
+        if (value.match(/^[a-z]+[A-Z]/) || value.includes(".")) {
             return value;
-        } 
+        }
         return value
         .toLowerCase()
-        .replace(/^([A-Z])|[\s-_](\w)/g, (_, p1, p2) => p2?.toUpperCase() || p1.toLowerCase());        
+        .replace(/^([A-Z])|[\s-_](\w)/g, (_, p1, p2) => p2?.toUpperCase() || p1.toLowerCase());
     }
 
     /**
@@ -300,7 +300,7 @@ export class StringUtils {
     static toKebabCase(value: string): string{
         return value.replace(/([a-z])([A-Z])/g, '$1-$2').replace(/[\s_]+/g, '-').toLowerCase();
     }
-    
+
     /**
      * Utilitário para remover caracteres em branco da string.
      * @param value String a ser removido os espaços.
@@ -311,30 +311,30 @@ export class StringUtils {
     }
 
     /**
-     * Utilitário para formatar bytes em string legível, convertendo para 
+     * Utilitário para formatar bytes em string legível, convertendo para
      * múltiplos maiores caso necessário.
      * @param byte quantidade de bytes a serem representados.
      * @returns string formatada de acordo com a unidade.
      */
     static formatBytes(bytes: number): string {
         const units = ["B", "KB", "MB", "GB"];
-    
+
         if (bytes < 1024) {
           return `${bytes.toString()}B`;
         }
-        
+
         const base = Math.log(bytes) / Math.log(1024);
         const offSet = Math.floor(base);
         if (offSet >= units.length) {
           return `${bytes.toString()}B`;
         }
-    
+
         const value = this.prettyPrecision(Math.pow(1024, base - offSet).toFixed(2).toString());
         const unit = units[offSet];
-    
+
         return `${value}${unit}`;
       }
-    
+
       /**
      * Método interno. Remove zeros depois da vírgula diminuindo o tamanho
      * da string.
@@ -366,4 +366,38 @@ export class StringUtils {
         return uuid();
     }
 
+    /**
+     * Checa se uma string pode ser convertida para letras maiúsculas ou minúsculas
+     *
+     * @param {string} original - A string a ser verificada
+     * @return {boolean} Se a string pode ser convertida
+     */
+    static isCaseable(original: string): boolean {
+        const uppercase = original.toUpperCase()
+        const lowercase = original.toLowerCase()
+
+        return original !== uppercase || original !== lowercase
+    }
+
+    /**
+     * Checa se uma string é minúscula
+     *
+     * @param {string} original - A string a ser verificada
+     * @return {boolean} Se a string é minúscula
+     */
+    static isLowerCase(original: string): boolean {
+        const uppercase = original.toUpperCase()
+
+        return this.isCaseable(original) && uppercase !== original
+    }
+
+    /**
+     * Inverte uma string de minúsculas para maiúsculas e vice-versa
+     *
+     * @param {string} original - A string a ser invertida
+     * @return {string} A string invertida
+     */
+    static getOppositeCase(original: string): string {
+        return this.isLowerCase(original) ? original.toUpperCase() : original.toLowerCase()
+    }
 }