ln-20-lib-components 0.0.11 → 0.0.13

package/lib/components/prime-ng/table-ng/table-ng.component.d.ts

@@ -0,0 +1,162 @@
+import type { OnDestroy, OnInit, Signal, TemplateRef, WritableSignal } from '@angular/core';
+import { type FormGroup } from '@angular/forms';
+import type { SortEvent } from 'primeng/api';
+import type { Table, TableFilterEvent, TableLazyLoadEvent } from 'primeng/table';
+import { ETypeInput } from '../../origin/form/enums';
+import type { IControlConfig } from '../../origin/form/interfaces';
+import type { IHttpMessage } from '../../origin/http-message/interfaces';
+import type { IPickListElement } from '../../origin/pick-list/interfaces';
+import type { IButtonConfig } from '../button-ng/interfaces';
+import { IPrimeNgSelection } from '../interfaces';
+import type { IEditTableNgConfig, IErrorConfig, IFooterConfig, IGlobalSearchForm, ILazyLoadResponse, IPipeConfig, ITableNgConfig, ITableNgData } from './interfaces';
+import * as i0 from "@angular/core";
+export declare class TableNgComponent<T extends Record<string, any> = Record<string, any>> implements OnInit, OnDestroy {
+    private readonly tableNgService;
+    private readonly tableNgEditService;
+    readonly data: import("@angular/core").ModelSignal<ITableNgData<T, unknown>[]>;
+    private loadingTimeout;
+    protected isLoading: WritableSignal<boolean>;
+    protected timeoutExpired: WritableSignal<boolean>;
+    readonly config: import("@angular/core").ModelSignal<ITableNgConfig | undefined>;
+    readonly editConfig: import("@angular/core").ModelSignal<IEditTableNgConfig<T> | undefined>;
+    readonly footerConfig: import("@angular/core").ModelSignal<IFooterConfig | undefined>;
+    toolbarButtons: import("@angular/core").ModelSignal<IButtonConfig<any>[]>;
+    sourceElements: import("@angular/core").ModelSignal<IPickListElement[]>;
+    targetElements: import("@angular/core").ModelSignal<IPickListElement[]>;
+    httpMessage: import("@angular/core").ModelSignal<IHttpMessage | undefined>;
+    lazyLoading: import("@angular/core").OutputEmitterRef<ILazyLoadResponse>;
+    outputChangeData: import("@angular/core").OutputEmitterRef<ITableNgData<T, unknown>[]>;
+    outputHandleEditInitButton: import("@angular/core").OutputEmitterRef<ITableNgData<T, unknown>>;
+    outputAddRow: import("@angular/core").OutputEmitterRef<ITableNgData<T, unknown>[]>;
+    outputDeleteRow: import("@angular/core").OutputEmitterRef<ITableNgData<T, unknown>>;
+    outputRowInlineChange: import("@angular/core").OutputEmitterRef<T>;
+    outputRowDataChange: import("@angular/core").OutputEmitterRef<ITableNgData<T, unknown>>;
+    outputEditData: import("@angular/core").OutputEmitterRef<ITableNgData<T, unknown>[]>;
+    outputIsEditing: import("@angular/core").OutputEmitterRef<boolean>;
+    resetData(): void;
+    advancedFiltersPerformed: string[];
+    advancedFiltersValues: WritableSignal<Record<string, Record<string, any>>>;
+    dt: Table;
+    private readonly fb;
+    constructor();
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    get hideToolbar(): boolean;
+    /**
+     * Calcula el número total de columnas para el colspan del mensaje vacío
+     */
+    protected totalColumns: Signal<number>;
+    isPrimeNgSelection(value: any): boolean;
+    hasErrorValues(object: Record<string, IErrorConfig>): boolean;
+    private rowFieldsValue;
+    rowFieldsHasValue: Signal<Record<string, boolean>>;
+    inlineChange(value: string | number | boolean | null | IPrimeNgSelection<string | boolean>, key: string): void;
+    trackById(index: number, item: {
+        id: any;
+    }): any;
+    frozenHandle(value: boolean | undefined): boolean;
+    isDate(value: any): boolean;
+    onFilter(event: TableFilterEvent): void;
+    resetRowDatas(): void;
+    get ETypeInput(): typeof ETypeInput;
+    handleAdvancedFiltersPerformed(filters: TableFilterEvent['filters']): void;
+    numberOfRecords: Signal<number>;
+    hasRecords: Signal<boolean>;
+    /**
+     * Computed que valida si al menos una fila tiene datos válidos en rowData.
+     * Retorna true si al menos una fila tiene un valor que no sea '', null o undefined.
+     * Retorna false si todas las filas tienen valores vacíos, null o undefined.
+     */
+    hasValidRowData: Signal<boolean>;
+    readonly keys: Signal<string[]>;
+    onRowClick(item: ITableNgData<T>): void;
+    protected scrollHeight: Signal<string>;
+    private parseValue;
+    paginatorStyleClass: Signal<string>;
+    showBottomToolbar: Signal<boolean>;
+    clearFilters(): void;
+    get filteredValue(): boolean;
+    clearFiltersButton: Signal<IButtonConfig>;
+    get controlsGlobalFilter(): IControlConfig[];
+    get searchFormGroupGlobalFilter(): FormGroup;
+    submitGlobalSearch(formGroup: FormGroup<IGlobalSearchForm>): void;
+    customSort(event: SortEvent): void;
+    selectedItems: import("@angular/core").ModelSignal<ITableNgData<T, unknown>[]>;
+    protected totalItemsSelected: Signal<number>;
+    protected showManagementSelectionConfig: Signal<boolean>;
+    protected buttonTotalItemsSelected: Signal<IButtonConfig>;
+    protected showSelectedItemsManagementButton: Signal<IButtonConfig>;
+    openModalManagementSelectedItems(): void;
+    inlineFormChanges(inlineValue: unknown, filter: (value: any) => void, typeInput?: ETypeInput, key?: string): void;
+    formChanges(formValue: Record<string, any>, filter: (value: any) => void, key: string): void;
+    rowDataKey(key: string): string;
+    onLazyLoad(event: TableLazyLoadEvent): void;
+    private getFiltersWithValue;
+    onCellValueChange(): void;
+    onRowDataChange(_data: ITableNgData<T>): void;
+    onEditData(): void;
+    get controlsEdit(): IControlConfig[];
+    get searchFormGroupEdit(): FormGroup;
+    customControlConfig(key: string, value: any): IControlConfig;
+    cellFormGroup: FormGroup;
+    addRowButton: Signal<IButtonConfig>;
+    addRow(): void;
+    private defaultTableNgData;
+    private clonedRowData;
+    private editingRowId;
+    /**
+     * Verifica si una fila específica está siendo editada
+     */
+    isRowEditing(id: string): boolean;
+    /**
+     * Verifica si hay alguna fila siendo editada actualmente
+     */
+    get hasRowInEdit(): boolean;
+    onRowEditInit(data: ITableNgData<T>): void;
+    private setEditingRowId;
+    onRowEditSave(_data: ITableNgData<T>): void;
+    onRowEditCancel(data: ITableNgData<T>, index: number): void;
+    private updateDataWithTableValue;
+    editInitButton: Signal<IButtonConfig>;
+    getEditInitButton(productId: string): IButtonConfig;
+    editSaveButton: Signal<IButtonConfig>;
+    editSaveButtonWithErrors: Signal<IButtonConfig>;
+    enableErrors: boolean;
+    setEnableErrors(value: boolean): void;
+    onEditSaveWithErrors(): void;
+    editCancelButton: Signal<IButtonConfig>;
+    deleteRowButton: Signal<IButtonConfig>;
+    getDeleteRowButton(): IButtonConfig;
+    removeRowFromData(data: ITableNgData<T>): void;
+    deleteRow(data: ITableNgData<T>): void;
+    get footerRows(): import("ln-20-lib-components").IFooterRow[][];
+    applyPipe(value: any, pipeConfig?: IPipeConfig): string;
+    protected rowExpansionButton(isRowExpanded: boolean): Signal<IButtonConfig>;
+    itemTemplateInput: import("@angular/core").InputSignal<TemplateRef<{
+        $implicit: T;
+    }> | null>;
+    itemTemplate: TemplateRef<{
+        $implicit: T;
+    }>;
+    get currentItemTemplate(): TemplateRef<{
+        $implicit: T;
+    }> | null;
+    isThatItemInTheProductSelection(field: string): boolean;
+    advancedIdentifierFiltersButton: Signal<IButtonConfig>;
+    openAdvancedIdentifierFilters(): void;
+    private handleTableValueToSourceElements;
+    private handleSelectedItemsToSourceElements;
+    private identifiersSelected;
+    get excelButton(): IButtonConfig;
+    get pdfButton(): IButtonConfig;
+    private lazyLoadingConfig;
+    private isEnabledLazyLoading;
+    private prepareDataForExport;
+    exportCSV(data: Record<string, T>[]): void;
+    protected exportData(dt: Table, endpoint: 'excel' | 'pdf'): void;
+    exportPDF(data: Record<string, T>[]): void;
+    enableExcelButton: Signal<boolean>;
+    enablePdfButton: Signal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TableNgComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TableNgComponent<any>, "lib-table-ng", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "editConfig": { "alias": "editConfig"; "required": false; "isSignal": true; }; "footerConfig": { "alias": "footerConfig"; "required": false; "isSignal": true; }; "toolbarButtons": { "alias": "toolbarButtons"; "required": false; "isSignal": true; }; "sourceElements": { "alias": "sourceElements"; "required": false; "isSignal": true; }; "targetElements": { "alias": "targetElements"; "required": false; "isSignal": true; }; "httpMessage": { "alias": "httpMessage"; "required": false; "isSignal": true; }; "selectedItems": { "alias": "selectedItems"; "required": false; "isSignal": true; }; "itemTemplateInput": { "alias": "itemTemplateInput"; "required": false; "isSignal": true; }; }, { "data": "dataChange"; "config": "configChange"; "editConfig": "editConfigChange"; "footerConfig": "footerConfigChange"; "toolbarButtons": "toolbarButtonsChange"; "sourceElements": "sourceElementsChange"; "targetElements": "targetElementsChange"; "httpMessage": "httpMessageChange"; "lazyLoading": "lazyLoading"; "outputChangeData": "outputChangeData"; "outputHandleEditInitButton": "outputHandleEditInitButton"; "outputAddRow": "outputAddRow"; "outputDeleteRow": "outputDeleteRow"; "outputRowInlineChange": "outputRowInlineChange"; "outputRowDataChange": "outputRowDataChange"; "outputEditData": "outputEditData"; "outputIsEditing": "outputIsEditing"; "selectedItems": "selectedItemsChange"; }, ["itemTemplate"], never, true, never>;
+}

package/lib/components/prime-ng/toolbar-ng/toolbar-ng.component.d.ts

@@ -0,0 +1,5 @@
+import * as i0 from "@angular/core";
+export declare class ToolbarNgComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToolbarNgComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ToolbarNgComponent, "lib-toolbar-ng", never, {}, {}, never, ["[toolbarStart]", "[toolbarCenter]", "[toolbarEnd]"], true, never>;
+}

package/lib/pipes/index.d.ts

@@ -0,0 +1 @@
+export * from './key-to-display-name.pipe';

package/lib/pipes/key-to-display-name.pipe.d.ts

@@ -0,0 +1,7 @@
+import type { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class KeyToDisplayNamePipe implements PipeTransform {
+    transform(key: string, keysNames?: Record<string, string>): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<KeyToDisplayNamePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<KeyToDisplayNamePipe, "keyToDisplayName", true>;
+}

package/lib/utils/api-error.util.d.ts

@@ -0,0 +1,58 @@
+import type { HttpErrorResponse } from '@angular/common/http';
+export interface IApiError {
+    errorCode: string;
+    message: string[] | string;
+    timestamp: string;
+    errors: IFieldError[];
+}
+export interface IFieldError {
+    field: string;
+    message: string;
+}
+/**
+ * Utilidades para manejar errores de API según la interfaz IApiError
+ */
+export declare class ApiErrorUtil {
+    /**
+     * Procesa errores de API y extrae el mensaje según la interfaz IApiError
+     * @param error - El error HTTP recibido
+     * @param fallbackMessage - Mensaje por defecto si no se puede extraer el mensaje del error
+     * @returns El mensaje de error procesado
+     */
+    static handleApiError(error: HttpErrorResponse, fallbackMessage: string): string;
+    /**
+     * Procesa errores de API con información detallada de campos
+     * y muestra tanto el mensaje general como los errores específicos de campo
+     * @param error - El error HTTP recibido
+     * @param fallbackMessage - Mensaje por defecto si no se puede extraer el mensaje del error
+     * @returns El mensaje de error procesado con información de campos si está disponible
+     */
+    static handleApiErrorWithFields(error: HttpErrorResponse, fallbackMessage: string): string;
+    /**
+     * Obtiene solo los errores de campo específicos
+     * @param error - El error HTTP recibido
+     * @returns Array de errores de campo o array vacío si no hay errores
+     */
+    static getFieldErrors(error: HttpErrorResponse): Array<{
+        field: string;
+        message: string;
+    }>;
+    /**
+     * Verifica si el error tiene errores de campo específicos
+     * @param error - El error HTTP recibido
+     * @returns true si hay errores de campo, false en caso contrario
+     */
+    static hasFieldErrors(error: HttpErrorResponse): boolean;
+    /**
+     * Obtiene el código de error específico
+     * @param error - El error HTTP recibido
+     * @returns El código de error o undefined si no está disponible
+     */
+    static getErrorCode(error: HttpErrorResponse): string | undefined;
+    /**
+     * Obtiene el timestamp del error
+     * @param error - El error HTTP recibido
+     * @returns El timestamp del error o undefined si no está disponible
+     */
+    static getErrorTimestamp(error: HttpErrorResponse): string | undefined;
+}

package/lib/utils/cookie.util.d.ts

@@ -0,0 +1,37 @@
+export declare class CookieUtil {
+    /**
+     * Obtiene el valor de una cookie por su nombre
+     * @param name - Nombre de la cookie
+     * @returns El valor de la cookie o null si no existe
+     */
+    static getCookie(name: string): string | null;
+    /**
+     * Establece una cookie
+     * @param name - Nombre de la cookie
+     * @param value - Valor de la cookie
+     * @param days - Días hasta que expire (por defecto 365)
+     * @param path - Ruta de la cookie (por defecto '/')
+     */
+    static setCookie(name: string, value: string, days?: number, path?: string): void;
+    /**
+     * Elimina una cookie
+     * @param name - Nombre de la cookie a eliminar
+     * @param path - Ruta de la cookie (por defecto '/')
+     */
+    static eraseCookie(name: string, path?: string): void;
+    /**
+     * Obtiene un valor booleano desde una cookie
+     * @param name - Nombre de la cookie
+     * @param defaultValue - Valor por defecto si la cookie no existe
+     * @returns El valor booleano
+     */
+    static getBooleanCookie(name: string, defaultValue?: boolean): boolean;
+    /**
+     * Establece un valor booleano en una cookie
+     * @param name - Nombre de la cookie
+     * @param value - Valor booleano
+     * @param days - Días hasta que expire (por defecto 365)
+     * @param path - Ruta de la cookie (por defecto '/')
+     */
+    static setBooleanCookie(name: string, value: boolean, days?: number, path?: string): void;
+}

package/lib/utils/currency.util.d.ts

@@ -0,0 +1 @@
+export declare const formatCurrency: (amount: number, currency: string) => string;

package/lib/utils/date.util.d.ts

@@ -0,0 +1,3 @@
+export declare const isSameDay: (date1: Date, date2: Date) => boolean;
+export declare const formatDateDMA: (date: Date) => string;
+export declare const formatDateDMAWithTime: (date: Date) => string;

package/lib/utils/documents.util.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Enum con los tipos de archivos más relevantes para la aplicación
+ */
+export declare enum EFileType {
+    PDF = "application/pdf",
+    DOC = "application/msword",
+    DOCX = "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    XLS = "application/vnd.ms-excel",
+    XLSX = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    PPT = "application/vnd.ms-powerpoint",
+    PPTX = "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    TXT = "text/plain",
+    RTF = "application/rtf",
+    JPG = "image/jpeg",
+    PNG = "image/png",
+    GIF = "image/gif",
+    BMP = "image/bmp",
+    SVG = "image/svg+xml",
+    WEBP = "image/webp",
+    ZIP = "application/zip",
+    RAR = "application/vnd.rar",
+    TAR = "application/x-tar",
+    GZ = "application/gzip",
+    CSV = "text/csv",
+    JSON = "application/json",
+    XML = "application/xml",
+    MP3 = "audio/mpeg",
+    WAV = "audio/wav",
+    OGG = "audio/ogg",
+    MP4 = "video/mp4",
+    AVI = "video/x-msvideo",
+    MOV = "video/quicktime",
+    WMV = "video/x-ms-wmv",
+    ALL_IMAGES = "image/*",
+    ALL_DOCUMENTS = "application/pdf,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document,application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-powerpoint,application/vnd.openxmlformats-officedocument.presentationml.presentation,text/plain,application/rtf",
+    ALL_FILES = "*/*"
+}
+/**
+ * Interfaz para el callback del archivo seleccionado
+ */
+export interface IFileSelectedCallback {
+    (file: File): void;
+}
+/**
+ * Interfaz para las opciones del trigger de archivo
+ */
+export interface ITriggerFileInputOptions {
+    accept?: EFileType;
+    multiple?: boolean;
+    onFileSelected?: IFileSelectedCallback;
+}
+/**
+ * Método mejorado para abrir el selector de archivos
+ * @param options - Opciones para configurar el input de archivo
+ */
+export declare const triggerFileInput: (options?: ITriggerFileInputOptions) => void;
+/**
+ * Interfaz para las opciones de captura de cámara
+ */
+export interface ICameraOptions {
+    width?: number;
+    height?: number;
+    quality?: number;
+    facingMode?: 'user' | 'environment';
+    onPhotoTaken?: (file: File) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Función para capturar una foto usando la cámara
+ */
+export declare const capturePhotoFromCamera: (options?: ICameraOptions) => Promise<void>;
+declare enum EFileIcons {
+    FILE = "file",
+    IMAGE = "image",
+    VIDEO = "video",
+    FOLDER = "folder",
+    EXCEL = "excel",
+    SIGNATURE = "signature",
+    CONTRACT = "contract",
+    FINGERPRINT = "fingerprint",
+    ID_CARD = "id_card",
+    FILE_BOX = "file_box",
+    SECURE_BUILDING = "secure_building",
+    POLICE = "police"
+}
+export declare const DocumentIcon: Record<EFileIcons, string>;
+export declare const downloadFile: (blob: Blob, fileName: string) => void;
+export {};

package/lib/utils/id.util.d.ts

@@ -0,0 +1 @@
+export declare const generateId: () => string;

package/lib/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from './api-error.util';
+export * from './cookie.util';
+export * from './currency.util';
+export * from './date.util';
+export * from './documents.util';
+export * from './id.util';
+export * from './number.util';
+export * from './objects.util';
+export * from './prime-ng.util';

package/lib/utils/number.util.d.ts

@@ -0,0 +1,2 @@
+export declare const formatNumber: (number: number) => string;
+export declare const fixedNumber: (number: number) => number;

package/lib/utils/objects.util.d.ts

@@ -0,0 +1,20 @@
+import type { IPrimeNgSelection } from '../components/prime-ng/interfaces';
+export declare const hasValues: (obj: Record<string, any>) => boolean;
+/**
+ * Elimina las propiedades de un objeto que tengan valores null o undefined.
+ * Retorna un nuevo objeto sin mutar el original.
+ * @param obj - Objeto del cual se eliminarán las propiedades null/undefined
+ * @returns Nuevo objeto sin las propiedades con valores null o undefined
+ */
+export declare const removeNullUndefined: <T extends Record<string, any>>(obj: T) => Partial<T>;
+/**
+ * Realiza un upsert en un array de strings. Si el string ya existe, no hace nada.
+ * Si no existe, lo agrega al array.
+ * @param targetArray - Array de strings donde se realizará el upsert
+ * @param value - String o array de strings a insertar
+ * @returns Array actualizado con los nuevos valores
+ */
+export declare const upsertArrayStrings: (targetArray: string[], value: string | string[]) => string[];
+export declare const sameArray: (arr1: unknown[], arr2: unknown[]) => boolean;
+export declare const getOptionByCode: <T>(options: IPrimeNgSelection<T>[], code: T | undefined) => IPrimeNgSelection<T> | undefined;
+export declare const createEnumeratedList: (items: string[]) => string;

package/lib/utils/prime-ng.util.d.ts

@@ -0,0 +1,3 @@
+export declare class PrimeNgUtil {
+    static isPrimeNgSelection(value: any): boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ln-20-lib-components",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "peerDependencies": {
     "@angular/common": "^19.0.0",
     "@angular/core": "^19.0.0",

package/lib/components/origin/button/button.component.d.ts

@@ -1,11 +0,0 @@
-import { EventEmitter, OnInit } from '@angular/core';
-import * as i0 from "@angular/core";
-export declare class ButtonComponent implements OnInit {
-    variant: 'primary' | 'secondary';
-    disabled: boolean;
-    onClick: EventEmitter<void>;
-    constructor();
-    ngOnInit(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ButtonComponent, "lib-button", never, { "variant": { "alias": "variant"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "onClick": "onClick"; }, never, ["*"], true, never>;
-}

package/lib/components/origin/empty-message/empty-message.component.d.ts

@@ -1,6 +0,0 @@
-import * as i0 from "@angular/core";
-export declare class EmptyMessageComponent {
-    message: import("@angular/core").InputSignal<string>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<EmptyMessageComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<EmptyMessageComponent, "lib-empty-message", never, { "message": { "alias": "message"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}