@gipisistemas/ngx-core 1.0.26 → 1.0.28

package/index.d.ts

@@ -4419,7 +4419,7 @@ declare class TreeTableMenuItemContextBuilder<TRow extends BaseModel = any> {
 declare class TreeTable<TNode extends BaseModel> implements OnInit {
     set tableFooterRef(value: ElementRef<HTMLElement> | null);
     set menuContextWrapperRef(value: ElementRef | null);
-    readonly matPaginatorRef: _angular_core.Signal<MatPaginator>;
+    readonly matPaginatorRef: _angular_core.Signal<MatPaginator | undefined>;
     readonly actionsRef: _angular_core.Signal<TemplateRef<unknown> | null | undefined>;
     readonly menuContextRef: _angular_core.Signal<TemplateRef<unknown> | null | undefined>;
     private readonly _uniqueId;
@@ -5383,7 +5383,8 @@ declare class CurrencyUtil {
      * @param inp Número a ser formatado.
      * @param options Configurações de formatação:
      *   - `digitsInfo` (opcional): Define o formato dos dígitos, como `1.2-2` (mínimo 1 inteiro, 2 casas decimais).
-     *   - `isPercent` (opcional): Se `true`, formata como porcentagem (ex: `0.5` → `50%`); caso contrário, como moeda (`R$`).
+     *   - `isPercent` (opcional): Se `true`, formata como porcentagem (ex: `0.5` → `50%`); caso contrário,
+     * como moeda (`R$`).
      *
      * @returns Uma string com o número formatado como moeda ou porcentagem.
      */
@@ -5656,11 +5657,17 @@ declare class DateUtil {
 declare class DocumentUtil {
     private static _isLastChar;
     /**
-     * Verifica se um valor é considerado vazio.
-     * @param inp O valor a ser verificado.
-     * @returns O valor sem formatação.
+     * Remove caracteres de formatação de um CPF/CNPJ.
+     *
+     * Caso o valor contenha letras, mantém apenas caracteres alfanuméricos.
+     * Caso contrário, mantém apenas números.
+     *
+     * @param value O valor que terá a formatação removida.
+     * @returns O valor sem caracteres de formatação.
+     *
      * @example
-     * DocumentUtil.isEmpty('123-123'); // Retorna `123123`.
+     * DocumentUtil.clearFormat('00.123.123/0001-12'); // Retorna: '00123123000112'
+     * DocumentUtil.clearFormat('XH.BYE.J7E/0001-67'); // Retorna: 'XHBYEJ7E000167'
      */
     static clearFormat(value: string): string;
     /**
@@ -5685,24 +5692,63 @@ declare class DocumentUtil {
      */
     static isValidCpf(cpf: string): boolean;
     /**
-     * Formata um CNPJ.
-     * @param cnpj O CNPJ a ser formatado.
-     * @param pad Se `true`, o CNPJ será preenchido com zeros à esquerda.
-     * @returns O CNPJ formatado.
+     * Formata um CNPJ numérico ou alfanumérico.
+     *
+     * A função remove automaticamente caracteres de formatação antes de aplicar
+     * a máscara padrão de CNPJ: `00.000.000/0000-00`.
+     *
+     * Também suporta:
+     * - CNPJ alfanumérico;
+     * - preenchimento automático com zeros à esquerda (`pad`);
+     * - formatação parcial para utilização em campos de digitação (`allowPartial`).
+     *
+     * Quando `allowPartial` estiver ativado, a máscara será aplicada
+     * gradualmente conforme a quantidade de caracteres informados.
+     *
+     * Caso `allowPartial` esteja desativado, apenas valores com 14 caracteres
+     * serão formatados. Caso contrário, será retornada uma string vazia.
+     *
+     * @param cnpj O CNPJ que será formatado.
+     * @param options Opções de formatação.
+     * @param options.pad Define se o valor deve ser preenchido com zeros à esquerda até atingir 14 caracteres.
+     * @param options.allowPartial Define se a máscara parcial deve ser aplicada durante a digitação.
+     *
+     * @returns O CNPJ formatado ou uma string vazia caso o valor seja inválido.
+     *
      * @example
-     * DocumentUtil.formatCnpj('00123123000112'); // Retorna `00.123.123/0001-12`.
-     * DocumentUtil.formatCnpj('123123000112', true); // Retorna `00.123.123/0001-12`.
-     */
-    static formatCnpj(cnpj: string, pad?: boolean): string;
+     * DocumentUtil.formatCnpj('12345678000190'); // Retorna: '12.345.678/0001-90'
+     * DocumentUtil.formatCnpj('12ABC3450001XX'); // Retorna: '12.ABC.345/0001-XX'
+     * DocumentUtil.formatCnpj('1234567890', { pad: true }); // Retorna: '00.001.234/5678-90'
+     * DocumentUtil.formatCnpj('12ABC345', { allowPartial: true }); // Retorna: '12.ABC.345'
+     * DocumentUtil.formatCnpj('123'); // Retorna: ''
+     */
+    static formatCnpj(cnpj: string, options?: {
+        pad?: boolean;
+        allowPartial?: boolean;
+    }): string;
     /**
-     * Verifica se um CNPJ é válido.
-     * @param cnpj O CNPJ a ser verificado.
-     * @returns `true` se o CNPJ for válido, caso contrário, `false`.
+     * Valida um CNPJ numérico ou alfanumérico.
+     *
+     * A função aceita CNPJ com ou sem máscara, remove os caracteres de formatação
+     * e valida o dígito verificador conforme a regra oficial baseada no valor ASCII
+     * do caractere subtraído de 48 (`charCodeAt(0) - 48`).
+     *
+     * Regras aplicadas:
+     * - aceita CNPJ numérico e alfanumérico;
+     * - aceita valores com máscara, como `12.345.678/0001-90`;
+     * - aceita letras minúsculas, convertendo internamente para maiúsculas;
+     * - exige exatamente 14 caracteres após a limpeza;
+     * - exige que os 2 últimos caracteres sejam dígitos verificadores numéricos;
+     * - rejeita sequências inválidas repetidas, como `00000000000000`, `11111111111111`, `AAAAAAAAAAAA00`, entre outras;
+     * - rejeita caracteres não permitidos.
+     *
+     * @param cnpj O CNPJ que será validado.
+     * @returns `true` se o CNPJ for válido, caso contrário `false`.
+     *
      * @example
-     * DocumentUtil.isValidCnpj('12.345.678/0001-09'); // Retorna `true`.
-     * DocumentUtil.isValidCnpj('12345678000109'); // Retorna `true`.
-     * DocumentUtil.isValidCnpj('1234567800010'); // Retorna `false`.
-     * DocumentUtil.isValidCnpj('123456780001090'); // Retorna `false`.
+     * DocumentUtil.isValidCnpj('12.345.678/0001-90'); // Retorna: true ou false conforme os dígitos verificadores.
+     * DocumentUtil.isValidCnpj('12ABC3450001XX'); // Retorna: false, pois os dois últimos caracteres devem ser números.
+     * DocumentUtil.isValidCnpj('AAAAAAAAAAAA00'); // Retorna: false.
      */
     static isValidCnpj(cnpj: string): boolean;
     /**
@@ -6103,7 +6149,8 @@ declare class StringUtil {
      */
     static removeAccents(inp: string): string;
     /**
-     * Trunca uma string para um tamanho máximo especificado e adiciona um sufixo (por padrão, '...') caso o limite seja ultrapassado.
+     * Trunca uma string para um tamanho máximo especificado e adiciona um sufixo (por padrão, '...')
+     * caso o limite seja ultrapassado.
      *
      * @param inp A string que será truncada.
      * @param maxLength O tamanho máximo da string antes do truncamento. (padrão é 50)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gipisistemas/ngx-core",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "Componentes e utilitários para projetos da GIPI Sistemas.",
   "author": "GIPI Sistemas",
   "license": "MIT",

package/theming/_utils.scss

@@ -621,7 +621,8 @@
     $font-color: get-font-color($theme);
     $mat-form-field-height: 3.6rem;
 
-    --mat-form-field-outlined-container-shape: 0.4rem;
+    --mat-form-field-outlined-container-shape: 0.6rem;
+    --mat-sys-corner-extra-small: 6px;
 
     $white-100: get-color($theme, white, 100);
 
@@ -901,7 +902,7 @@
 //     $font-color: get-font-color($theme);
 //     $mat-form-field-height: 3.6rem;
 
-//     --mat-form-field-outlined-container-shape: 0.4rem;
+//     --mat-form-field-outlined-container-shape: 0.6rem;
 
 //     $white-100: get-color($theme, white, 100);