@senior-agronegocio/angular-components 0.0.9884 → 1.0.0

package/README.md

@@ -0,0 +1,25 @@
+# AngularComponents
+
+This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 18.2.0.
+
+## Code scaffolding
+
+Run `ng generate component component-name --project angular-components` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module --project angular-components`.
+
+> Note: Don't forget to add `--project angular-components` or else it will be added to the default project in your `angular.json` file.
+
+## Build
+
+Run `ng build angular-components` to build the project. The build artifacts will be stored in the `dist/` directory.
+
+## Publishing
+
+After building your library with `ng build angular-components`, go to the dist folder `cd dist/angular-components` and run `npm publish`.
+
+## Running unit tests
+
+Run `ng test angular-components` to execute the unit tests via [Karma](https://karma-runner.github.io).
+
+## Further help
+
+To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.

package/agro-angular-components.module.d.ts

@@ -1,9 +1,13 @@
-import { ModuleWithProviders, InjectionToken } from "@angular/core";
-export declare const HostProjectConfigsInjectionToken: InjectionToken<HostProjectConfigs>;
-export interface HostProjectConfigs {
-    domain: string;
-    service: string;
-}
-export declare class AgroAngularComponentsModule {
-    static forRoot(config: HostProjectConfigs): ModuleWithProviders<AgroAngularComponentsModule>;
-}
+import { ModuleWithProviders, InjectionToken } from "@angular/core";
+import * as i0 from "@angular/core";
+export interface HostProjectConfigs {
+    domain: string;
+    service: string;
+}
+export declare const LIB_CONFIG: InjectionToken<HostProjectConfigs>;
+export declare class AgroAngularComponentsModule {
+    static forRoot(config: HostProjectConfigs): ModuleWithProviders<AgroAngularComponentsModule>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AgroAngularComponentsModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AgroAngularComponentsModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AgroAngularComponentsModule>;
+}

package/common/agro-array-utils.class.d.ts

@@ -1,48 +1,48 @@
-/**
- * Classe com funções úteis para Arrays.
- */
-export declare class AgroArrayUtils {
-    /**
-     * Verifica se o valor informado é um array.
-     */
-    static isArray(value: any): boolean;
-    /**
-     * Remove um item de um array.
-     * @param array Array de onde o item será removido.
-     * @param item Item a ser removido.
-     */
-    static removeItem(array: any[], item: any): void;
-    /**
-     * Remove um item de um array por índice.
-     * @param array Array de onde o item será removido.
-     * @param index Índice do item a ser removido.
-     */
-    static removeItemByIndex(array: any[], index: number): void;
-    /**
-     * Remove todos os itens de um array.
-     * @param array Array de onde os itens serão removidos.
-     */
-    static removeAllItems(array: any[]): void;
-    /**
-     * Verifica se um array é vazio.
-     * @param array Array a ser verificado.
-     */
-    static isEmpty(array: any[]): boolean;
-    /**
-     * Verifica se um array é vazio.
-     * @param array Array a ser verificado.
-     */
-    static isNotEmpty(array: any[]): boolean;
-    /**
-     * Localiza um item em um array de objetos de acordo com a propriedade e valor informados.
-     */
-    static findItemByProperty(array: any[], property: string, value: any): any;
-    /**
-     * Valida se dois arrays são iguais.
-     * Considera se os arrays possuem os mesmos elementos na mesma ordem.
-     * @param arr1
-     * @param arr2
-     * @returns
-     */
-    static arraysAreEqual(arr1: any[], arr2: any[]): boolean;
-}
+/**
+ * Classe com funções úteis para Arrays.
+ */
+export declare class AgroArrayUtils {
+    /**
+     * Verifica se o valor informado é um array.
+     */
+    static isArray(value: any): boolean;
+    /**
+     * Remove um item de um array.
+     * @param array Array de onde o item será removido.
+     * @param item Item a ser removido.
+     */
+    static removeItem(array: any[], item: any): void;
+    /**
+     * Remove um item de um array por índice.
+     * @param array Array de onde o item será removido.
+     * @param index Índice do item a ser removido.
+     */
+    static removeItemByIndex(array: any[], index: number): void;
+    /**
+     * Remove todos os itens de um array.
+     * @param array Array de onde os itens serão removidos.
+     */
+    static removeAllItems(array: any[]): void;
+    /**
+     * Verifica se um array é vazio.
+     * @param array Array a ser verificado.
+     */
+    static isEmpty(array: any[]): boolean;
+    /**
+     * Verifica se um array é vazio.
+     * @param array Array a ser verificado.
+     */
+    static isNotEmpty(array: any[]): boolean;
+    /**
+     * Localiza um item em um array de objetos de acordo com a propriedade e valor informados.
+     */
+    static findItemByProperty(array: any[], property: string, value: any): any;
+    /**
+     * Valida se dois arrays são iguais.
+     * Considera se os arrays possuem os mesmos elementos na mesma ordem.
+     * @param arr1
+     * @param arr2
+     * @returns
+     */
+    static arraysAreEqual(arr1: any[], arr2: any[]): boolean;
+}

package/common/agro-cookie-utils.class.d.ts

@@ -1,9 +1,9 @@
-export { AgroCookieUtils as ACU, AgroCookieUtils as CookieUtils };
-export declare class AgroCookieUtils {
-    static getCookie(name: string, parseURIValue?: boolean): string | undefined;
-    static parseCookieToObject(cookieString: string, parseURIString?: boolean): {
-        [key: string]: string;
-    };
-    static isStringAnObject(str: string): boolean;
-    static setCookie(name: string, value: string, days: number): void;
-}
+export { AgroCookieUtils as ACU, AgroCookieUtils as CookieUtils };
+export declare class AgroCookieUtils {
+    static getCookie(name: string, parseURIValue?: boolean): string | undefined;
+    static parseCookieToObject(cookieString: string, parseURIString?: boolean): {
+        [key: string]: string;
+    };
+    static isStringAnObject(str: string): boolean;
+    static setCookie(name: string, value: string, days: number): void;
+}

package/common/agro-date-utils.class.d.ts

@@ -1,88 +1,88 @@
-export declare class AgroDateUtils {
-    /**
-     * Verifica se uma data é nula ou indefinida.
-     * @param date - A data a ser verificada.
-     * @returns True se a data for nula ou indefinida, false caso contrário.
-     */
-    static isNullOrUndefined(date: Date | null | undefined): boolean;
-    /**
-     * Verifica se uma data não é nula e não é indefinida.
-     * @param date - A data a ser verificada.
-     * @returns True se a data não for nula e não for indefinida, false caso contrário.
-     */
-    static isNotNullOrUndefined(date: Date | null | undefined): boolean;
-    /**
-     * Verifica se uma data é válida.
-     * @param date - A data a ser verificada.
-     * @returns True se a data for válida, false caso contrário.
-     */
-    static isValid(date: string): boolean;
-    /**
-     * Verifica se uma data é inválida.
-     * @param date - A data a ser verificada.
-     * @returns True se a data for inválida, false caso contrário.
-     */
-    static isInvalid(date: string): boolean;
-    /**
-     * Verifica se uma data é antes de outra data.
-     * @param date - A data a ser verificada.
-     * @param otherDate - A outra data a ser comparada.
-     * @returns True se a data for antes da outra data, false caso contrário.
-     */
-    static isBefore(date: Date, otherDate: Date): boolean;
-    /**
-     * Verifica se uma data é depois de outra data.
-     * @param date - A data a ser verificada.
-     * @param otherDate - A outra data a ser comparada.
-     * @returns True se a data for depois da outra data, false caso contrário.
-     */
-    static isAfter(date: Date, otherDate: Date): boolean;
-    /**
-     * Verifica se uma data é igual a outra data.
-     * @param date - A data a ser verificada.
-     * @param otherDate - A outra data a ser comparada.
-     * @returns True se a data for igual a outra data, false caso contrário.
-     */
-    static isEqual(date: Date, otherDate: Date): boolean;
-    /**
-     * Verifica se uma data é menor ou igual a outra data.
-     * @param date - A data a ser verificada.
-     * @param otherDate - A outra data a ser comparada.
-     * @returns True se a data for menor ou igual a outra data, false caso contrário.
-     */
-    static isLessOrEqual(date: Date, otherDate: Date): boolean;
-    /**
-     * Verifica se uma data é maior ou igual a outra data.
-     * @param date - A data a ser verificada.
-     * @param otherDate - A outra data a ser comparada.
-     * @returns True se a data for maior ou igual a outra data, false caso contrário.
-     */
-    static isGreaterOrEqual(date: Date, otherDate: Date): boolean;
-    /**
-     * Verifica se uma data é menor que outra data.
-     * @param date - A data a ser verificada.
-     * @param otherDate - A outra data a ser comparada.
-     * @returns True se a data for menor que outra data, false caso contrário.
-     */
-    static isLess(date: Date, otherDate: Date): boolean;
-    /**
-     * Verifica se uma data é maior que outra data.
-     * @param date - A data a ser verificada.
-     * @param otherDate - A outra data a ser comparada.
-     * @returns True se a data for maior que outra data, false caso contrário.
-     */
-    static isGreater(date: Date, otherDate: Date): boolean;
-    /**
-     * Retorna a data formatada conforme o formato especificado.
-     * @param date
-     * @param format
-     * @returns
-     */
-    static formatDate(date: Date, format?: string): string;
-    /**
-     * Retorna uma string com o número informado adicionando um 0 à esquerda, caso o número seja menor que 10.
-     * @param value
-     * @returns
-     */
-    static padZero(value: number): string;
-}
+export declare class AgroDateUtils {
+    /**
+     * Verifica se uma data é nula ou indefinida.
+     * @param date - A data a ser verificada.
+     * @returns True se a data for nula ou indefinida, false caso contrário.
+     */
+    static isNullOrUndefined(date: Date | null | undefined): boolean;
+    /**
+     * Verifica se uma data não é nula e não é indefinida.
+     * @param date - A data a ser verificada.
+     * @returns True se a data não for nula e não for indefinida, false caso contrário.
+     */
+    static isNotNullOrUndefined(date: Date | null | undefined): boolean;
+    /**
+     * Verifica se uma data é válida.
+     * @param date - A data a ser verificada.
+     * @returns True se a data for válida, false caso contrário.
+     */
+    static isValid(date: string): boolean;
+    /**
+     * Verifica se uma data é inválida.
+     * @param date - A data a ser verificada.
+     * @returns True se a data for inválida, false caso contrário.
+     */
+    static isInvalid(date: string): boolean;
+    /**
+     * Verifica se uma data é antes de outra data.
+     * @param date - A data a ser verificada.
+     * @param otherDate - A outra data a ser comparada.
+     * @returns True se a data for antes da outra data, false caso contrário.
+     */
+    static isBefore(date: Date, otherDate: Date): boolean;
+    /**
+     * Verifica se uma data é depois de outra data.
+     * @param date - A data a ser verificada.
+     * @param otherDate - A outra data a ser comparada.
+     * @returns True se a data for depois da outra data, false caso contrário.
+     */
+    static isAfter(date: Date, otherDate: Date): boolean;
+    /**
+     * Verifica se uma data é igual a outra data.
+     * @param date - A data a ser verificada.
+     * @param otherDate - A outra data a ser comparada.
+     * @returns True se a data for igual a outra data, false caso contrário.
+     */
+    static isEqual(date: Date, otherDate: Date): boolean;
+    /**
+     * Verifica se uma data é menor ou igual a outra data.
+     * @param date - A data a ser verificada.
+     * @param otherDate - A outra data a ser comparada.
+     * @returns True se a data for menor ou igual a outra data, false caso contrário.
+     */
+    static isLessOrEqual(date: Date, otherDate: Date): boolean;
+    /**
+     * Verifica se uma data é maior ou igual a outra data.
+     * @param date - A data a ser verificada.
+     * @param otherDate - A outra data a ser comparada.
+     * @returns True se a data for maior ou igual a outra data, false caso contrário.
+     */
+    static isGreaterOrEqual(date: Date, otherDate: Date): boolean;
+    /**
+     * Verifica se uma data é menor que outra data.
+     * @param date - A data a ser verificada.
+     * @param otherDate - A outra data a ser comparada.
+     * @returns True se a data for menor que outra data, false caso contrário.
+     */
+    static isLess(date: Date, otherDate: Date): boolean;
+    /**
+     * Verifica se uma data é maior que outra data.
+     * @param date - A data a ser verificada.
+     * @param otherDate - A outra data a ser comparada.
+     * @returns True se a data for maior que outra data, false caso contrário.
+     */
+    static isGreater(date: Date, otherDate: Date): boolean;
+    /**
+     * Retorna a data formatada conforme o formato especificado.
+     * @param date
+     * @param format
+     * @returns
+     */
+    static formatDate(date: Date, format?: string): string;
+    /**
+     * Retorna uma string com o número informado adicionando um 0 à esquerda, caso o número seja menor que 10.
+     * @param value
+     * @returns
+     */
+    static padZero(value: number): string;
+}

package/common/agro-logics.class.d.ts

@@ -1,23 +1,23 @@
-declare type AnyRecord = Record<string, any>;
-export interface DistributionResult<T> {
-    data: Partial<T>;
-    samplingSuccess: number;
-    samplingQuantity: number;
-}
-export declare class AgroLogics {
-    private static readonly FAHRENHEIT_OFFSET;
-    private static readonly FAHRENHEIT_NUMERATOR;
-    private static readonly FAHRENHEIT_DENOMINATOR;
-    private static readonly KELVIN_OFFSET;
-    private static readonly PERCENT;
-    /**
-     * Agrupa o conjunto de dados pelos campos de entidade fornecidos e calcula
-     * a distribuição de probabilidade (frequência e porcentagem).
-     *
-     * @param data - Array de objetos a serem analisados
-     * @param keys - Chaves ou caminhos aninhados para agrupar (ex: ["entity1", "entity2"])
-     * @returns Array de estatísticas agrupadas ordenadas por samplingSuccess (decrescente)
-     */
-    static entityDistributionStats<T extends AnyRecord>(data: T[], keys: (keyof T | string)[]): DistributionResult<T>[];
-}
-export {};
+type AnyRecord = Record<string, any>;
+export interface DistributionResult<T> {
+    data: Partial<T>;
+    samplingSuccess: number;
+    samplingQuantity: number;
+}
+export declare class AgroLogics {
+    private static readonly FAHRENHEIT_OFFSET;
+    private static readonly FAHRENHEIT_NUMERATOR;
+    private static readonly FAHRENHEIT_DENOMINATOR;
+    private static readonly KELVIN_OFFSET;
+    private static readonly PERCENT;
+    /**
+     * Agrupa o conjunto de dados pelos campos de entidade fornecidos e calcula
+     * a distribuição de probabilidade (frequência e porcentagem).
+     *
+     * @param data - Array de objetos a serem analisados
+     * @param keys - Chaves ou caminhos aninhados para agrupar (ex: ["entity1", "entity2"])
+     * @returns Array de estatísticas agrupadas ordenadas por samplingSuccess (decrescente)
+     */
+    static entityDistributionStats<T extends AnyRecord>(data: T[], keys: (keyof T | string)[]): DistributionResult<T>[];
+}
+export {};

package/common/agro-name-utils.class.d.ts

@@ -1,22 +1,22 @@
-export declare class AgroNameUtils {
-    /**
-     * Abrevia o último sobrenome, mantendo o primeiro nome completo.
-     * @param fullName valor completo do nome (Ex: Tiago Batista Corrêa)
-     * @returns nome abreviado (Ex: Tiago C.)
-     */
-    static abbreviateName(fullName: string): string | null;
-    /**
-     * Abrevia todos os sobrenomes, mantendo o primeiro nome completo.
-     *
-     * @param fullName O nome completo. (Ex: Tiago Batista Corrêa)
-     * @returns O nome com os sobrenomes abreviados. (Ex: Tiago B. C.)
-     */
-    static abbreviateAllLastNames(fullName: string): string | null;
-    /**
-     * Retorna as iniciais do nome completo.
-     *
-     * @param fullName O nome completo. (Ex: Tiago Batista Corrêa)
-     * @returns Uma string contendo as iniciais do nome. (Ex: TBC)
-     */
-    static getInitials(fullName: string): string | null;
-}
+export declare class AgroNameUtils {
+    /**
+     * Abrevia o último sobrenome, mantendo o primeiro nome completo.
+     * @param fullName valor completo do nome (Ex: Tiago Batista Corrêa)
+     * @returns nome abreviado (Ex: Tiago C.)
+     */
+    static abbreviateName(fullName: string): string | null;
+    /**
+     * Abrevia todos os sobrenomes, mantendo o primeiro nome completo.
+     *
+     * @param fullName O nome completo. (Ex: Tiago Batista Corrêa)
+     * @returns O nome com os sobrenomes abreviados. (Ex: Tiago B. C.)
+     */
+    static abbreviateAllLastNames(fullName: string): string | null;
+    /**
+     * Retorna as iniciais do nome completo.
+     *
+     * @param fullName O nome completo. (Ex: Tiago Batista Corrêa)
+     * @returns Uma string contendo as iniciais do nome. (Ex: TBC)
+     */
+    static getInitials(fullName: string): string | null;
+}

package/common/agro-number-utils.class.d.ts

@@ -1,77 +1,77 @@
-/**
- * Classe de utilitários para operações com números.
- */
-export declare class AgroNumberUtils {
-    /**
-     * Verifica se um número é nulo ou indefinido.
-     * @param num - O número a ser verificado.
-     * @returns True se o número for nulo ou indefinido, false caso contrário.
-     */
-    static isNullOrUndefined(num: any): boolean;
-    /**
-     * Verifica se um número não é nulo e não é indefinido.
-     * @param num - O número a ser verificado.
-     * @returns True se o número não for nulo e não for indefinido, false caso contrário.
-     */
-    static isNotNullOrUndefined(num: any): boolean;
-    /**
-     * Verifica se um número é par.
-     *
-     * @param value O número a ser verificado.
-     * @returns True se for par, false caso contrário.
-     */
-    static isEven(value: number): boolean;
-    /**
-     * Verifica se um número é ímpar.
-     *
-     * @param value O número a ser verificado.
-     * @returns True se for ímpar, false caso contrário.
-     */
-    static isOdd(value: number): boolean;
-    /**
-     * Calcula a porcentagem de um valor em relação a um total.
-     *
-     * @param partial O valor parcial.
-     * @param total O valor total.
-     * @returns A porcentagem calculada.
-     */
-    static percentage(partial: number, total: number): number;
-    /**
-     * Formata um número para o formato monetário.
-     *
-     * @param value O número a ser formatado.
-     * @param currency O símbolo da moeda (padrão: "BRL").
-     * @param locale O código da localidade (padrão: "pt-BR").
-     * @returns Uma string no formato monetário.
-     */
-    static toCurrency(value: number, currency?: string, locale?: string): string;
-    /**
-     * Gera um número aleatório no intervalo especificado.
-     *
-     * @param min O valor mínimo (inclusivo).
-     * @param max O valor máximo (exclusivo).
-     * @returns Um número aleatório no intervalo.
-     */
-    static randomInRange(min: number, max: number): number;
-    /**
-     * Verifica se um número é primo.
-     *
-     * @param value O número a ser verificado.
-     * @returns True se for primo, false caso contrário.
-     */
-    static isPrime(value: number): boolean;
-    /**
-     * Arredonda um número para `n` casas decimais.
-     *
-     * @param value O número a ser arredondado.
-     * @param decimals O número de casas decimais (padrão: 2).
-     * @returns O número arredondado.
-     */
-    static roundTo(value: number, decimals?: number): number;
-    /**
-     * Pega apenas números, convertendo strings para números e retornarndo apenas o maior inteiro encontrado.
-     * @param value - O valor a ser processado.
-     * @returns O maior número inteiro encontrado ou 0 se nenhum número for encontrado.
-     */
-    static getNearInteger(value: any): number;
-}
+/**
+ * Classe de utilitários para operações com números.
+ */
+export declare class AgroNumberUtils {
+    /**
+     * Verifica se um número é nulo ou indefinido.
+     * @param num - O número a ser verificado.
+     * @returns True se o número for nulo ou indefinido, false caso contrário.
+     */
+    static isNullOrUndefined(num: any): boolean;
+    /**
+     * Verifica se um número não é nulo e não é indefinido.
+     * @param num - O número a ser verificado.
+     * @returns True se o número não for nulo e não for indefinido, false caso contrário.
+     */
+    static isNotNullOrUndefined(num: any): boolean;
+    /**
+     * Verifica se um número é par.
+     *
+     * @param value O número a ser verificado.
+     * @returns True se for par, false caso contrário.
+     */
+    static isEven(value: number): boolean;
+    /**
+     * Verifica se um número é ímpar.
+     *
+     * @param value O número a ser verificado.
+     * @returns True se for ímpar, false caso contrário.
+     */
+    static isOdd(value: number): boolean;
+    /**
+     * Calcula a porcentagem de um valor em relação a um total.
+     *
+     * @param partial O valor parcial.
+     * @param total O valor total.
+     * @returns A porcentagem calculada.
+     */
+    static percentage(partial: number, total: number): number;
+    /**
+     * Formata um número para o formato monetário.
+     *
+     * @param value O número a ser formatado.
+     * @param currency O símbolo da moeda (padrão: "BRL").
+     * @param locale O código da localidade (padrão: "pt-BR").
+     * @returns Uma string no formato monetário.
+     */
+    static toCurrency(value: number, currency?: string, locale?: string): string;
+    /**
+     * Gera um número aleatório no intervalo especificado.
+     *
+     * @param min O valor mínimo (inclusivo).
+     * @param max O valor máximo (exclusivo).
+     * @returns Um número aleatório no intervalo.
+     */
+    static randomInRange(min: number, max: number): number;
+    /**
+     * Verifica se um número é primo.
+     *
+     * @param value O número a ser verificado.
+     * @returns True se for primo, false caso contrário.
+     */
+    static isPrime(value: number): boolean;
+    /**
+     * Arredonda um número para `n` casas decimais.
+     *
+     * @param value O número a ser arredondado.
+     * @param decimals O número de casas decimais (padrão: 2).
+     * @returns O número arredondado.
+     */
+    static roundTo(value: number, decimals?: number): number;
+    /**
+     * Pega apenas números, convertendo strings para números e retornarndo apenas o maior inteiro encontrado.
+     * @param value - O valor a ser processado.
+     * @returns O maior número inteiro encontrado ou 0 se nenhum número for encontrado.
+     */
+    static getNearInteger(value: any): number;
+}

package/common/agro-object-stringifier.class.d.ts

@@ -1,16 +1,16 @@
-import { PipeTransform } from "@angular/core";
-export declare type UsePipes = {
-    [key: string]: PipeTransform | string;
-};
-export declare class AgroObjectStringifier {
-    /**
-     * Formata um objeto concatenando valores segundo as chaves e pipes informados.
-     *
-     * @param separator Separador entre os valores (ex: "-")
-     * @param fields Campos a extrair. Podem conter subpropriedades ("propriedade.subPropriedade") e pipes ("propriedade|nomeDaPipe:arg1:arg2")
-     * @param obj Objeto origem
-     */
-    static formatObject(separator: string, fields: string[], obj: any, usePipes?: UsePipes): string;
-    /** Resolve um caminho tipo "empresa.cargo" dentro de um objeto */
-    private static resolvePath;
-}
+import { PipeTransform } from "@angular/core";
+export type UsePipes = {
+    [key: string]: PipeTransform | string;
+};
+export declare class AgroObjectStringifier {
+    /**
+     * Formata um objeto concatenando valores segundo as chaves e pipes informados.
+     *
+     * @param separator Separador entre os valores (ex: "-")
+     * @param fields Campos a extrair. Podem conter subpropriedades ("propriedade.subPropriedade") e pipes ("propriedade|nomeDaPipe:arg1:arg2")
+     * @param obj Objeto origem
+     */
+    static formatObject(separator: string, fields: string[], obj: any, usePipes?: UsePipes): string;
+    /** Resolve um caminho tipo "empresa.cargo" dentro de um objeto */
+    private static resolvePath;
+}