ngx-dsxlibrary 2.21.74 → 2.21.76

package/types/ngx-dsxlibrary.d.ts

@@ -8,7 +8,7 @@ import * as rxjs from 'rxjs';
 import { Observable, Subject } from 'rxjs';
 import { SweetAlertIcon, SweetAlertTheme, SweetAlertResult } from 'sweetalert2';
 import { HttpClient, HttpInterceptorFn, HttpParams, HttpHeaders, HttpErrorResponse, HttpResponse } from '@angular/common/http';
-import * as i17 from 'primeng/fileupload';
+import * as i18 from 'primeng/fileupload';
 import { FileUpload } from 'primeng/fileupload';
 import { AnimationOptions } from 'ngx-lottie';
 import * as i7 from '@angular/router';
@@ -26,53 +26,54 @@ import * as i6 from 'primeng/badge';
 import * as i7$1 from 'primeng/button';
 import * as i8$1 from 'primeng/card';
 import * as i9 from 'primeng/checkbox';
-import * as i10 from 'primeng/contextmenu';
-import * as i11 from 'primeng/dataview';
-import * as i12 from 'primeng/datepicker';
-import * as i13 from 'primeng/dialog';
-import * as i14 from 'primeng/divider';
-import * as i15 from 'primeng/drawer';
-import * as i16 from 'primeng/fieldset';
-import * as i18 from 'primeng/floatlabel';
-import * as i19 from 'primeng/iconfield';
-import * as i20 from 'primeng/image';
-import * as i21 from 'primeng/inputicon';
-import * as i22 from 'primeng/inputmask';
-import * as i23 from 'primeng/inputnumber';
+import * as i10 from 'primeng/chip';
+import * as i11 from 'primeng/contextmenu';
+import * as i12 from 'primeng/dataview';
+import * as i13 from 'primeng/datepicker';
+import * as i14 from 'primeng/dialog';
+import * as i15 from 'primeng/divider';
+import * as i16 from 'primeng/drawer';
+import * as i17 from 'primeng/fieldset';
+import * as i19 from 'primeng/floatlabel';
+import * as i20 from 'primeng/iconfield';
+import * as i21 from 'primeng/image';
+import * as i22 from 'primeng/inputicon';
+import * as i23 from 'primeng/inputmask';
+import * as i24 from 'primeng/inputnumber';
 import { InputNumber } from 'primeng/inputnumber';
-import * as i24 from 'primeng/inputtext';
-import * as i25 from 'primeng/keyfilter';
-import * as i26 from 'primeng/knob';
-import * as i27 from 'primeng/menubar';
-import * as i28 from 'primeng/message';
-import * as i29 from 'primeng/multiselect';
-import * as i30 from 'primeng/organizationchart';
-import * as i31 from 'primeng/overlaybadge';
-import * as i32 from 'primeng/panelmenu';
-import * as i33 from 'primeng/password';
-import * as i34 from 'primeng/picklist';
-import * as i35 from 'primeng/popover';
-import * as i36 from 'primeng/radiobutton';
-import * as i37 from 'primeng/rating';
-import * as i38 from 'primeng/ripple';
-import * as i39 from 'primeng/scroller';
-import * as i40 from 'primeng/scrollpanel';
-import * as i41 from 'primeng/selectbutton';
-import * as i42 from 'primeng/select';
-import * as i43 from 'primeng/slider';
-import * as i44 from 'primeng/speeddial';
-import * as i45 from 'primeng/splitbutton';
-import * as i46 from 'primeng/stepper';
-import * as i47 from 'primeng/table';
-import * as i48 from 'primeng/tabs';
-import * as i49 from 'primeng/tag';
-import * as i50 from 'primeng/textarea';
-import * as i51 from 'primeng/timeline';
-import * as i52 from 'primeng/toast';
-import * as i53 from 'primeng/togglebutton';
-import * as i54 from 'primeng/tooltip';
-import * as i55 from 'primeng/tree';
-import * as i56 from 'primeng/treetable';
+import * as i25 from 'primeng/inputtext';
+import * as i26 from 'primeng/keyfilter';
+import * as i27 from 'primeng/knob';
+import * as i28 from 'primeng/menubar';
+import * as i29 from 'primeng/message';
+import * as i30 from 'primeng/multiselect';
+import * as i31 from 'primeng/organizationchart';
+import * as i32 from 'primeng/overlaybadge';
+import * as i33 from 'primeng/panelmenu';
+import * as i34 from 'primeng/password';
+import * as i35 from 'primeng/picklist';
+import * as i36 from 'primeng/popover';
+import * as i37 from 'primeng/radiobutton';
+import * as i38 from 'primeng/rating';
+import * as i39 from 'primeng/ripple';
+import * as i40 from 'primeng/scroller';
+import * as i41 from 'primeng/scrollpanel';
+import * as i42 from 'primeng/selectbutton';
+import * as i43 from 'primeng/select';
+import * as i44 from 'primeng/slider';
+import * as i45 from 'primeng/speeddial';
+import * as i46 from 'primeng/splitbutton';
+import * as i47 from 'primeng/stepper';
+import * as i48 from 'primeng/table';
+import * as i49 from 'primeng/tabs';
+import * as i50 from 'primeng/tag';
+import * as i51 from 'primeng/textarea';
+import * as i52 from 'primeng/timeline';
+import * as i53 from 'primeng/toast';
+import * as i54 from 'primeng/togglebutton';
+import * as i55 from 'primeng/tooltip';
+import * as i56 from 'primeng/tree';
+import * as i57 from 'primeng/treetable';
 import * as ngx_dsxlibrary from 'ngx-dsxlibrary';
 
 declare class DsxStatusToggle implements ControlValueAccessor {
@@ -214,14 +215,32 @@ declare class DocxPreviewComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DocxPreviewComponent, "app-docx-preview", never, { "visible": { "alias": "visible"; "required": false; }; "blob": { "alias": "blob"; "required": false; "isSignal": true; }; }, { "visibleChange": "visibleChange"; }, never, never, true, never>;
 }
 
+type SupportedMimeType = 'application/pdf' | 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp';
 declare class PdfPreviewComponent implements OnDestroy {
     private sanitizer;
     visible: _angular_core.ModelSignal<boolean>;
     blob: _angular_core.InputSignal<Blob | null>;
     private objectUrl;
-    pdfUrl: SafeResourceUrl | null;
+    fileUrl: SafeResourceUrl | null;
+    fileType: SupportedMimeType | null;
+    fileName: string;
+    fileSize: string;
+    private rawBlob;
+    private readonly mimeTypeMap;
+    private readonly supportedTypes;
+    private readonly iconMap;
     constructor(sanitizer: DomSanitizer);
+    private isFileSupported;
+    private getFileNameFromBlob;
+    private formatFileSize;
     private limpiarUrlAnterior;
+    get isPdf(): boolean;
+    get isImage(): boolean;
+    get fileTypeLabel(): string;
+    getFileIcon(): string;
+    downloadFile(): void;
+    onImageLoad(): void;
+    onImageError(): void;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PdfPreviewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PdfPreviewComponent, "app-pdf-preview", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "blob": { "alias": "blob"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; }, never, never, true, never>;
@@ -419,22 +438,23 @@ declare class AppMessageHelpComponent implements AfterViewInit, DoCheck, OnDestr
  * - `import`   → Importar datos desde archivo (azul acero)
  */
 declare const ACTION_TYPES: {
+    readonly cancel: "cancel";
+    readonly create: "create";
+    readonly details: "details";
+    readonly download: "download";
+    readonly edit: "edit";
+    readonly export: "export";
     readonly hardDelete: "hardDelete";
-    readonly softDelete: "softDelete";
-    readonly return: "return";
     readonly home: "home";
-    readonly validate: "validate";
+    readonly import: "import";
+    readonly refresh: "refresh";
     readonly restore: "restore";
-    readonly edit: "edit";
-    readonly create: "create";
+    readonly return: "return";
     readonly save: "save";
+    readonly softDelete: "softDelete";
     readonly update: "update";
-    readonly refresh: "refresh";
-    readonly details: "details";
+    readonly validate: "validate";
     readonly view: "view";
-    readonly export: "export";
-    readonly download: "download";
-    readonly import: "import";
 };
 type ActionType = (typeof ACTION_TYPES)[keyof typeof ACTION_TYPES];
 interface ActionMessageConfig {
@@ -535,7 +555,7 @@ declare class DsxButtonComponent {
     tooltipOverride: _angular_core.InputSignal<string | undefined>;
     iconOverride: _angular_core.InputSignal<string | undefined>;
     primeIconOverride: _angular_core.InputSignal<string | undefined>;
-    colorOverride: _angular_core.InputSignal<"view" | "success" | "info" | "danger" | "details" | "return" | "restore" | "download" | "import" | "warning" | "brown" | "caution" | "cyan" | "excel" | "magenta" | "neutral" | "olive" | "primary" | "slate" | "upload" | undefined>;
+    colorOverride: _angular_core.InputSignal<"view" | "success" | "info" | "danger" | "details" | "download" | "import" | "restore" | "return" | "warning" | "brown" | "caution" | "cyan" | "excel" | "magenta" | "neutral" | "olive" | "primary" | "slate" | "upload" | undefined>;
     outlinedOverride: _angular_core.InputSignal<boolean | undefined>;
     showValidateButtonOverride: _angular_core.InputSignal<boolean | undefined>;
     showRestoreButtonOverride: _angular_core.InputSignal<boolean | undefined>;
@@ -606,6 +626,94 @@ declare class IconDsxComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconDsxComponent, "icon-dsx", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "debug": { "alias": "debug"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+interface Holiday {
+    dateHoliday: Date | string;
+    labelHoliday: string;
+}
+
+interface CalendarDay {
+    date: Date;
+    day: number;
+    isCurrentMonth: boolean;
+    isSunday: boolean;
+    isInRange: boolean;
+    isStart: boolean;
+    isEnd: boolean;
+    isHoliday: boolean;
+    holidayLabel?: string;
+    disabled: boolean;
+    rangePosition?: number;
+}
+interface MonthData {
+    label: string;
+    days: CalendarDay[];
+}
+interface RangeKPI {
+    totalDays: number;
+    businessDays: number;
+    holidays: number;
+    sundays: number;
+    holidaysList: Holiday[];
+    startDate: string;
+    endDate: string;
+}
+interface FormattedHoliday {
+    date: string;
+    label: string;
+}
+declare class DsxCalendarView {
+    startDate: _angular_core.ModelSignal<string | Date | null>;
+    endDate: _angular_core.ModelSignal<string | Date | null>;
+    excludeSundays: _angular_core.ModelSignal<boolean>;
+    holidays: _angular_core.InputSignal<Holiday[]>;
+    compactMode: _angular_core.InputSignal<boolean>;
+    showKPI: _angular_core.InputSignal<boolean>;
+    debugMode: _angular_core.InputSignal<boolean>;
+    isEdit: _angular_core.InputSignal<boolean>;
+    showControls: _angular_core.InputSignal<boolean>;
+    rangeChanged: _angular_core.OutputEmitterRef<{
+        start: string;
+        end: string;
+    }>;
+    startDateStr: _angular_core.WritableSignal<string>;
+    endDateStr: _angular_core.WritableSignal<string>;
+    readonly isDevMode: boolean;
+    shouldShowControls: _angular_core.Signal<boolean>;
+    months: _angular_core.Signal<MonthData[]>;
+    formattedHolidays: _angular_core.Signal<FormattedHoliday[]>;
+    kpi: _angular_core.Signal<RangeKPI | null>;
+    constructor();
+    private normalizeDateToString;
+    private formatInputDate;
+    private emitRangeChange;
+    onStartDateChange(event: Event): void;
+    onEndDateChange(event: Event): void;
+    onToggleSundays(event: Event): void;
+    private generateMonth;
+    private getDaysBetween;
+    private isDateInRange;
+    private isSameDay;
+    private formatDate;
+    /**
+     * Verifica si debemos mostrar logs
+     * ✅ Usa isDevMode() de Angular - simple y confiable
+     */
+    private shouldLog;
+    /**
+     * Log de depuración - Solo visible en desarrollo con debugMode=true
+     * 🔥 NUNCA se ejecuta en producción
+     */
+    private logDebug;
+    /**
+     * Log de rendimiento - Mide tiempos de ejecución
+     * 🔥 NUNCA se ejecuta en producción
+     */
+    private logPerformance;
+    chunk(arr: any[], size: number): any[][];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsxCalendarView, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DsxCalendarView, "dsx-calendar-view", never, { "startDate": { "alias": "startDate"; "required": false; "isSignal": true; }; "endDate": { "alias": "endDate"; "required": false; "isSignal": true; }; "excludeSundays": { "alias": "excludeSundays"; "required": false; "isSignal": true; }; "holidays": { "alias": "holidays"; "required": false; "isSignal": true; }; "compactMode": { "alias": "compactMode"; "required": false; "isSignal": true; }; "showKPI": { "alias": "showKPI"; "required": false; "isSignal": true; }; "debugMode": { "alias": "debugMode"; "required": false; "isSignal": true; }; "isEdit": { "alias": "isEdit"; "required": false; "isSignal": true; }; "showControls": { "alias": "showControls"; "required": false; "isSignal": true; }; }, { "startDate": "startDateChange"; "endDate": "endDateChange"; "excludeSundays": "excludeSundaysChange"; "rangeChanged": "rangeChanged"; }, never, never, true, never>;
+}
+
 declare class FileComponent implements ControlValueAccessor, Validator, AfterViewInit, OnDestroy {
     existingFile: _angular_core.InputSignal<File | null>;
     existingFileName: _angular_core.InputSignal<string | null>;
@@ -688,8 +796,8 @@ declare class JsonValuesDebujComponent implements OnDestroy {
     readonly shouldShowLogs: _angular_core.Signal<boolean>;
     constructor();
     private findFilesInObject;
+    private serializeValue;
     private updateSerializedValue;
-    private cloneWithFileProcessing;
     private updateFileInfo;
     hasFileProperty(): boolean;
     getFileInfo(): any;
@@ -2152,7 +2260,7 @@ declare class DsxAddToolsModule {
 
 declare class PrimeNgModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PrimeNgModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<PrimeNgModule, never, never, [typeof i1.AccordionModule, typeof i2.AutoCompleteModule, typeof i3.AutoFocusModule, typeof i4.AvatarGroupModule, typeof i5.AvatarModule, typeof i6.BadgeModule, typeof i7$1.ButtonModule, typeof i8$1.CardModule, typeof i9.CheckboxModule, typeof i10.ContextMenuModule, typeof i11.DataViewModule, typeof i12.DatePickerModule, typeof i13.DialogModule, typeof i14.DividerModule, typeof i15.DrawerModule, typeof i16.FieldsetModule, typeof i17.FileUploadModule, typeof i18.FloatLabelModule, typeof i19.IconFieldModule, typeof i20.ImageModule, typeof i21.InputIconModule, typeof i22.InputMaskModule, typeof i23.InputNumberModule, typeof i24.InputTextModule, typeof i25.KeyFilterModule, typeof i26.KnobModule, typeof i27.MenubarModule, typeof i28.MessageModule, typeof i29.MultiSelectModule, typeof i30.OrganizationChartModule, typeof i31.OverlayBadgeModule, typeof i32.PanelMenuModule, typeof i33.PasswordModule, typeof i34.PickListModule, typeof i35.PopoverModule, typeof i36.RadioButtonModule, typeof i37.RatingModule, typeof i38.RippleModule, typeof i39.ScrollerModule, typeof i40.ScrollPanelModule, typeof i41.SelectButtonModule, typeof i42.SelectModule, typeof i43.SliderModule, typeof i44.SpeedDialModule, typeof i45.SplitButtonModule, typeof i46.StepperModule, typeof i47.TableModule, typeof i48.TabsModule, typeof i49.TagModule, typeof i50.TextareaModule, typeof i51.TimelineModule, typeof i52.ToastModule, typeof i53.ToggleButtonModule, typeof i54.TooltipModule, typeof i55.TreeModule, typeof i56.TreeTableModule]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<PrimeNgModule, never, never, [typeof i1.AccordionModule, typeof i2.AutoCompleteModule, typeof i3.AutoFocusModule, typeof i4.AvatarGroupModule, typeof i5.AvatarModule, typeof i6.BadgeModule, typeof i7$1.ButtonModule, typeof i8$1.CardModule, typeof i9.CheckboxModule, typeof i10.ChipModule, typeof i11.ContextMenuModule, typeof i12.DataViewModule, typeof i13.DatePickerModule, typeof i14.DialogModule, typeof i15.DividerModule, typeof i16.DrawerModule, typeof i17.FieldsetModule, typeof i18.FileUploadModule, typeof i19.FloatLabelModule, typeof i20.IconFieldModule, typeof i21.ImageModule, typeof i22.InputIconModule, typeof i23.InputMaskModule, typeof i24.InputNumberModule, typeof i25.InputTextModule, typeof i26.KeyFilterModule, typeof i27.KnobModule, typeof i28.MenubarModule, typeof i29.MessageModule, typeof i30.MultiSelectModule, typeof i31.OrganizationChartModule, typeof i32.OverlayBadgeModule, typeof i33.PanelMenuModule, typeof i34.PasswordModule, typeof i35.PickListModule, typeof i36.PopoverModule, typeof i37.RadioButtonModule, typeof i38.RatingModule, typeof i39.RippleModule, typeof i40.ScrollerModule, typeof i41.ScrollPanelModule, typeof i42.SelectButtonModule, typeof i43.SelectModule, typeof i44.SliderModule, typeof i45.SpeedDialModule, typeof i46.SplitButtonModule, typeof i47.StepperModule, typeof i48.TableModule, typeof i49.TabsModule, typeof i50.TagModule, typeof i51.TextareaModule, typeof i52.TimelineModule, typeof i53.ToastModule, typeof i54.ToggleButtonModule, typeof i55.TooltipModule, typeof i56.TreeModule, typeof i57.TreeTableModule]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<PrimeNgModule>;
 }
 
@@ -3779,6 +3887,14 @@ declare class ParameterValuesService<T extends string = string> {
 interface ReferenceMap {
     [key: string]: any;
 }
+/**
+ * Tipos de formato de fecha disponibles
+ * @example
+ * 'date'      -> "07/04/2026"
+ * 'dateLong'  -> "07 de abril de 2026"
+ * 'dateTime'  -> "07/04/2026 14:30"
+ */
+type DateFormat = 'date' | 'dateLong' | 'dateTime';
 /**
  * Configuración de un campo para el preview del formulario
  */
@@ -3787,28 +3903,71 @@ interface FieldConfig {
     key: string;
     /** Etiqueta que se mostrará en la vista */
     label: string;
-    /** Función opcional para formatear el valor */
-    format?: (value: any) => string;
+    /**
+     * Formato para el valor:
+     * - String: 'date' | 'dateLong' | 'dateTime' (formatos predefinidos)
+     * - Función: (value) => string (formato personalizado)
+     *
+     * @example
+     * // Formato predefinido
+     * format: 'dateLong'
+     *
+     * // Formato personalizado
+     * format: (value) => {
+     *   if (!value) return '';
+     *   const date = new Date(value);
+     *   return date.toLocaleDateString('es-ES', {
+     *     weekday: 'long',
+     *     day: '2-digit',
+     *     month: 'long',
+     *     year: 'numeric'
+     *   });
+     * }
+     */
+    format?: ((value: any) => string) | DateFormat;
     /**
      * Mapa de referencia para traducir IDs a nombres legibles.
      * Puede ser: Map, Array, objeto literal o función.
-     * Ejemplos:
-     * - Map: new Map([[1, 'Activo'], [2, 'Inactivo']])
-     * - Array: [{id: 1, nombre: 'Activo'}, {id: 2, nombre: 'Inactivo'}]
-     * - Objeto: {1: 'Activo', 2: 'Inactivo'}
-     * - Función: (id) => obtenerNombre(id)
+     *
+     * @example
+     * // Array de objetos (usa key como ID por defecto)
+     * referenceMap: [{ id: 1, nombre: 'Activo' }, { id: 2, nombre: 'Inactivo' }]
+     *
+     * // Array con propiedades personalizadas
+     * referenceMap: [{ empleadoId: 1, nombreCompleto: 'Juan Pérez' }]
+     * referenceId: 'empleadoId'
+     * referenceLabel: 'nombreCompleto'
+     *
+     * // Función para búsqueda personalizada
+     * referenceMap: (id) => this.empleados.find(emp => emp.id === id)?.nombre
+     *
+     * // Map para búsqueda eficiente
+     * referenceMap: new Map([[1, 'Activo'], [2, 'Inactivo']])
+     *
+     * // Objeto literal
+     * referenceMap: { 1: 'Activo', 2: 'Inactivo' }
      */
     referenceMap?: Map<any, any> | any[] | ReferenceMap | ((id: any) => any);
-    /**
-     * Propiedad del objeto de referencia que se usará como etiqueta.
-     * Por defecto: 'nombre'
-     */
-    referenceLabel?: string;
     /**
      * Propiedad del objeto de referencia que se usará como ID.
-     * Por defecto: 'id'
+     * Si no se especifica, usa el 'key' del campo o 'id' por defecto.
+     * @default 'id'
+     *
+     * @example
+     * // Si tu objeto usa 'empleadoId' en lugar de 'id'
+     * referenceId: 'empleadoId'
      */
     referenceId?: string;
+    /**
+     * Propiedad del objeto de referencia que se usará como etiqueta.
+     * Si no se especifica, usa 'nombre' por defecto.
+     * @default 'nombre'
+     *
+     * @example
+     * // Si tu objeto usa 'nombreCompleto' en lugar de 'nombre'
+     * referenceLabel: 'nombreCompleto'
+     */
+    referenceLabel?: string;
 }
 /**
  * Opciones de configuración para el preview
@@ -3833,13 +3992,14 @@ interface OptionsConfig {
     compact?: boolean;
     /**
      * Si es true, habilita logs de depuración.
-     * Solo funciona en entorno de desarrollo.
-     * ¡No afecta en producción!
+     * ⚠️ SOLO funciona en entorno de desarrollo.
+     * ¡NUNCA se ejecuta en producción!
      */
     debug?: boolean;
 }
 declare class FormPreviewService {
     private readonly environment;
+    private readonly isDev;
     constructor();
     /**
      * Construye el HTML para el preview de un objeto
@@ -3850,17 +4010,30 @@ declare class FormPreviewService {
      *
      * @example
      * ```typescript
+     * // Ejemplo básico
      * const data = {
-     *   usuario: {
-     *     nombre: 'Juan Pérez',
-     *     email: 'juan@email.com'
-     *   },
+     *   empleadoId: 2,
+     *   fechaIngreso: '2026-04-07',
      *   estado: 1
      * };
      *
+     * const empleados = [
+     *   { id: 1, nombreCompleto: 'Juan Pérez' },
+     *   { id: 2, nombreCompleto: 'María García' }
+     * ];
+     *
      * const fields = [
-     *   { key: 'usuario.nombre', label: 'Nombre' },
-     *   { key: 'usuario.email', label: 'Email' },
+     *   {
+     *     key: 'empleadoId',
+     *     label: 'Empleado',
+     *     referenceMap: empleados,
+     *     referenceLabel: 'nombreCompleto'
+     *   },
+     *   {
+     *     key: 'fechaIngreso',
+     *     label: 'Fecha de Ingreso',
+     *     format: 'dateLong'  // "07 de abril de 2026"
+     *   },
      *   {
      *     key: 'estado',
      *     label: 'Estado',
@@ -3868,23 +4041,83 @@ declare class FormPreviewService {
      *   }
      * ];
      *
-     * const html = this.formPreviewService.buildObjectSummaryHtml(data, fields, {
-     *   title: 'Datos del Usuario',
-     *   showEmpty: false,
-     *   compact: true,
-     *   debug: false
-     * });
+     * const html = this.formPreviewService.buildObjectSummaryHtml(
+     *   data,
+     *   fields,
+     *   {
+     *     title: 'Datos del Usuario',
+     *     showEmpty: false,
+     *     compact: true,
+     *     debug: true  // Solo en desarrollo
+     *   }
+     * );
      * ```
      */
     buildObjectSummaryHtml(data: any, fields: FieldConfig[], options?: OptionsConfig): string;
+    /**
+     * Resuelve el valor de referencia
+     * Soporta: arrays, maps, objetos literales y funciones
+     */
     private resolveReferenceValue;
+    /**
+     * Resuelve un valor individual de referencia
+     */
     private resolveSingleReference;
+    /**
+     * Obtiene un valor anidado usando notación punto
+     * @example
+     * getNestedValue({ user: { name: 'Juan' } }, 'user.name') // 'Juan'
+     */
     private getNestedValue;
+    /**
+     * Formatea un valor usando el formato especificado
+     * @param value - Valor a formatear
+     * @param format - Formato a aplicar (string predefinido o función personalizada)
+     * @returns String formateado
+     */
     private formatValue;
+    /**
+     * Formato por defecto para cualquier valor
+     */
+    private formatDefault;
+    /**
+     * 🗓️ FORMATOS DE FECHA DISPONIBLES
+     *
+     * Para agregar un nuevo formato:
+     * 1. Agrega el tipo en DateFormat
+     * 2. Agrega el case en el switch del método formatDate
+     * 3. Define las opciones de Intl.DateTimeFormatOptions
+     *
+     * @example
+     * // Agregar 'dateShort' para mostrar "07-abr-2026"
+     * // 1. type DateFormat = 'date' | 'dateLong' | 'dateTime' | 'dateShort'
+     * // 2. case 'dateShort':
+     * //    options.day = '2-digit';
+     * //    options.month = 'short';
+     * //    options.year = 'numeric';
+     * //    break;
+     */
+    private formatDate;
+    /**
+     * Formatea un valor individual (para objetos y arrays)
+     */
     private formatSingleValue;
+    /**
+     * Genera el HTML del preview
+     */
     private generateHtml;
+    /**
+     * 🔍 Debug: Muestra información detallada para depuración
+     * ⚠️ SOLO se ejecuta en entorno de desarrollo
+     */
     private debugInputData;
+    /**
+     * Encuentra propiedades similares para sugerencias en debug
+     */
     private findSimilarProperties;
+    /**
+     * Escapa caracteres HTML para evitar inyección
+     */
     private escapeHtml;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FormPreviewService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<FormPreviewService>;
@@ -4758,6 +4991,50 @@ declare const GTQFormatter: Intl.NumberFormat;
  */
 declare function createCurrencyFormatter(locale: string, currency: string): Intl.NumberFormat;
 
+/**
+ * Guarda un valor en localStorage
+ * Soporta: strings, números, objetos, arrays, null, undefined
+ */
+declare function setStorage<T>(key: string, value: T): void;
+/**
+ * Obtiene un valor desde localStorage
+ * @param defaultValue - Valor por defecto si no existe la clave
+ * @returns El valor guardado o el defaultValue
+ */
+declare function getStorage<T>(key: string, defaultValue?: T): T | undefined;
+declare function setStorageObject<T extends Record<string, any>>(key: string, values?: Partial<T>, merge?: boolean): void;
+/**
+ * 🆕 Función para eliminar una clave del storage
+ */
+declare function removeStorage(key: string): void;
+/**
+ * 🆕 Función para verificar si existe una clave en el storage
+ */
+declare function hasStorage(key: string): boolean;
+
+/**
+ * Calcula la fecha sumando días hábiles (Lunes a Sábado, Domingos no cuentan)
+ * Los feriados en el rango no consumen días
+ *
+ * @param fechaInicio - Fecha desde donde empezar
+ * @param cantidadDias - Días hábiles a sumar
+ * @param feriados - Lista de feriados (opcional)
+ * @returns Fecha calculada o null si fechaInicio es null
+ *
+ * @example
+ * // Sin feriados
+ * calcularFechaFin(new Date('2026-07-07'), 15) // 2026-07-25
+ *
+ * @example
+ * // Con feriados
+ * calcularFechaFin(
+ *   new Date('2026-07-07'),
+ *   15,
+ *   [{ date: '2026-07-14' }, { date: '2026-07-21' }]
+ * ) // 2026-07-27
+ */
+declare function dsxCalcularRangoFecha(fechaInicio: Date | null, cantidadDias: number, feriados?: Holiday[]): Date | null;
+
 declare function chainControlGroups(form: FormGroup, groups: string[][]): void;
 
 /**
@@ -4895,5 +5172,5 @@ declare function minimumAgeValidator(minimumAge: number, referenceDate?: Date):
 
 declare function sorensenDiceValidator(dataSource: any[] | Observable<any[]>, key?: string, umbral?: number): AsyncValidatorFn;
 
-export { ACTION_TYPES, AlertaService, AppMessageErrorComponent, AppMessageHelpComponent, ArrowNavigationDirective, AuthorizeService, AutoScrollHeightDirective, BaseCRUDService, CACHE_KEYS, CacheService, CssV2Component, DSX_PALETTE, DateIndicator, DocxPreviewComponent, DsxAddToolsModule, DsxAutocomplete, DsxButtonComponent, DsxEnableDisable, DsxInputCurrency, DsxMessagesService, DsxSelect, DsxStatusToggle, DsxdateShort, DsxdateTime, DteService, ENVIRONMENT, EndpointService, ErrorHandlerService, FileComponent, FormPreviewService, GTQFormatter, HeaderDsx, HelpersService, HttpHelpersService, INITIAL_PARAMETERS, IcoLabel, IconDsxComponent, JoinByPipe, JsonHighlightPipe, JsonValuesDebujComponent, JsonViewerComponent, KpicardComponent, LoadingComponent, LoadingLottieComponent, LogoDsxComponent, MasterDetailChangeService, NavbarDsxComponent, NetworkStatusComponent, OnlyRangoPatternDirective, ParameterValuesService, PdfPreviewComponent, PrimeNgModule, QrGenerator, ResultFileService, SWEET_ALERT_THEMES, ScreenInspector, SecurityService, SelectAllOnFocusDirective, SpinnerLoadingService, SweetAlert2DialogService, TablePreviewService, TemplateHighlight, TokenPurposeLogin, TruncatePipe, UtilityAddService, asyncExistsValidator, atLeastOneFieldRequiredValidator, chainControlGroups, createCurrencyFormatter, createInitialCache, createTypedCacheProvider, cuiValidator, dateMinMaxValidator, dateRangeValidator, dateRangeValidatorFromTo, developmentEnvironment, getActionMessageConfig, getZeroBasedRolIndex, guardTokenPurposeGuard, httpAuthorizeInterceptor, minimumAgeValidator, nitValidator, productionEnvironment, provideEnvironment, sorensenDiceValidator, templateStructureValidator, templateVariablesValidator, validateEnvironmentConfig };
-export type { ActionMessageConfig, ActionType, AppEnvironment, AsyncExistsValidatorOptions, AutoCompleteCompleteEvent, BlobRequestOptions$1 as BlobRequestOptions, Certificacion, Column, Complemento, Complementos, DataLoginModel, DataToken, DatosEmision, DatosGenerales, DevEnvironmentComplete, DevEnvironmentDefaults, Direccion, DocumentoFelResponse, DsxColorToken, DsxValidateUnique, Dte, Emisor, EnvironmentConfig, ExportColumn, FechasConversion, FieldConfig$1 as FieldConfig, FileData, FilterOption, FormRule, Frase, Frases, HttpParamValue$1 as HttpParamValue, HttpParamsRecord$1 as HttpParamsRecord, Impuesto, Impuestos, InferCacheKeyType, InferCacheOptions, Item, Items, MasterDetailChangeResult, MasterDetailDifference, MasterDetailRawEntity, MasterDetailSimpleFormOptions, MasterDetailSimpleFormTracker, MasterDetailState, MyParameterValues, NITResponse, NumeroAutorizacion, ParameterSecurity, ParameterValue, ProdEnvironmentComplete, ProdEnvironmentDefaults, ReactiveForm, Receptor, ResponseHttpModel, Sat, SeguridadITParameter, ServiceResult, ServiceResultVoid, SweetAlertThemeType, T, TableColumn, TipoFechaConversion, TotalImpuesto, Totales, TypedForm, jwtSecurityModel, typeModel };
+export { ACTION_TYPES, AlertaService, AppMessageErrorComponent, AppMessageHelpComponent, ArrowNavigationDirective, AuthorizeService, AutoScrollHeightDirective, BaseCRUDService, CACHE_KEYS, CacheService, CssV2Component, DSX_PALETTE, DateIndicator, DocxPreviewComponent, DsxAddToolsModule, DsxAutocomplete, DsxButtonComponent, DsxCalendarView, DsxEnableDisable, DsxInputCurrency, DsxMessagesService, DsxSelect, DsxStatusToggle, DsxdateShort, DsxdateTime, DteService, ENVIRONMENT, EndpointService, ErrorHandlerService, FileComponent, FormPreviewService, GTQFormatter, HeaderDsx, HelpersService, HttpHelpersService, INITIAL_PARAMETERS, IcoLabel, IconDsxComponent, JoinByPipe, JsonHighlightPipe, JsonValuesDebujComponent, JsonViewerComponent, KpicardComponent, LoadingComponent, LoadingLottieComponent, LogoDsxComponent, MasterDetailChangeService, NavbarDsxComponent, NetworkStatusComponent, OnlyRangoPatternDirective, ParameterValuesService, PdfPreviewComponent, PrimeNgModule, QrGenerator, ResultFileService, SWEET_ALERT_THEMES, ScreenInspector, SecurityService, SelectAllOnFocusDirective, SpinnerLoadingService, SweetAlert2DialogService, TablePreviewService, TemplateHighlight, TokenPurposeLogin, TruncatePipe, UtilityAddService, asyncExistsValidator, atLeastOneFieldRequiredValidator, chainControlGroups, createCurrencyFormatter, createInitialCache, createTypedCacheProvider, cuiValidator, dateMinMaxValidator, dateRangeValidator, dateRangeValidatorFromTo, developmentEnvironment, dsxCalcularRangoFecha, getActionMessageConfig, getStorage, getZeroBasedRolIndex, guardTokenPurposeGuard, hasStorage, httpAuthorizeInterceptor, minimumAgeValidator, nitValidator, productionEnvironment, provideEnvironment, removeStorage, setStorage, setStorageObject, sorensenDiceValidator, templateStructureValidator, templateVariablesValidator, validateEnvironmentConfig };
+export type { ActionMessageConfig, ActionType, AppEnvironment, AsyncExistsValidatorOptions, AutoCompleteCompleteEvent, BlobRequestOptions$1 as BlobRequestOptions, CalendarDay, Certificacion, Column, Complemento, Complementos, DataLoginModel, DataToken, DatosEmision, DatosGenerales, DevEnvironmentComplete, DevEnvironmentDefaults, Direccion, DocumentoFelResponse, DsxColorToken, DsxValidateUnique, Dte, Emisor, EnvironmentConfig, ExportColumn, FechasConversion, FieldConfig$1 as FieldConfig, FileData, FilterOption, FormRule, FormattedHoliday, Frase, Frases, Holiday, HttpParamValue$1 as HttpParamValue, HttpParamsRecord$1 as HttpParamsRecord, Impuesto, Impuestos, InferCacheKeyType, InferCacheOptions, Item, Items, MasterDetailChangeResult, MasterDetailDifference, MasterDetailRawEntity, MasterDetailSimpleFormOptions, MasterDetailSimpleFormTracker, MasterDetailState, MonthData, MyParameterValues, NITResponse, NumeroAutorizacion, ParameterSecurity, ParameterValue, ProdEnvironmentComplete, ProdEnvironmentDefaults, RangeKPI, ReactiveForm, Receptor, ResponseHttpModel, Sat, SeguridadITParameter, ServiceResult, ServiceResultVoid, SweetAlertThemeType, T, TableColumn, TipoFechaConversion, TotalImpuesto, Totales, TypedForm, jwtSecurityModel, typeModel };