@litigiovirtual/ius-design-components 1.0.280 → 1.0.282

package/lib/date-hour-picker/date-hour-picker.component.d.ts

@@ -13,6 +13,19 @@ export declare class DateHourPickerComponent {
     iconHelp: boolean;
     isRequired: boolean;
     mode: 'date-only' | 'time-only' | 'date-time';
+    /**
+     * Muestra un botón "X" a la derecha (igual que ius-input-textfield) para limpiar el
+     * valor cuando hay uno seleccionado. Opt-in: por defecto OFF para no cambiar el
+     * comportamiento de los usos existentes (muchos son campos requeridos de un solo valor).
+     */
+    isEnableClear: boolean;
+    /**
+     * Valor controlado por el padre. Acepta Date, string (los mismos formatos que emite
+     * este picker) o null/''. Asignar null/'' LIMPIA el valor mostrado. NO dispara
+     * (dateSelected) — solo refleja lo que el padre setea. Sirve para precargar (editar)
+     * o limpiar el campo desde afuera (ej. botón "Borrar filtros").
+     */
+    set value(v: Date | string | null | undefined);
     dateSelected: EventEmitter<string>;
     onBlurEvent: EventEmitter<void>;
     private connectedOverlay;
@@ -37,6 +50,11 @@ export declare class DateHourPickerComponent {
     ngOnInit(): void;
     private updateLabelAndPlaceholder;
     toggleCalendar(): void;
+    /**
+     * Limpia el valor seleccionado desde el botón "X". Detiene la propagación para no abrir
+     * el calendario, y EMITE '' (interacción del usuario) para que el padre actualice su estado.
+     */
+    clearValue(event: MouseEvent): void;
     goToToday(): void;
     selectTime(): void;
     getDisplayValue(): string;
@@ -53,8 +71,14 @@ export declare class DateHourPickerComponent {
     generateCalendarDays(): void;
     closeCalendar(): void;
     handleOutsideClick(event: MouseEvent): void;
+    /**
+     * Parsea el valor que entra por [value]. Date -> tal cual. String -> soporta los
+     * formatos que emite este picker. "YYYY-MM-DD" se interpreta como fecha LOCAL para
+     * evitar el corrimiento de -1 día que produce new Date('YYYY-MM-DD') (UTC).
+     */
+    private parseIncomingValue;
     private buildSelectedDateFromState;
     private emitSelection;
     static ɵfac: i0.ɵɵFactoryDeclaration<DateHourPickerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DateHourPickerComponent, "ius-date-hour-picker", never, { "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "error": { "alias": "error"; "required": false; }; "helpText": { "alias": "helpText"; "required": false; }; "helpTextError": { "alias": "helpTextError"; "required": false; }; "errorText": { "alias": "errorText"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "iconHelp": { "alias": "iconHelp"; "required": false; }; "isRequired": { "alias": "isRequired"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; }, { "dateSelected": "dateSelected"; "onBlurEvent": "onBlurEvent"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DateHourPickerComponent, "ius-date-hour-picker", never, { "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "error": { "alias": "error"; "required": false; }; "helpText": { "alias": "helpText"; "required": false; }; "helpTextError": { "alias": "helpTextError"; "required": false; }; "errorText": { "alias": "errorText"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "iconHelp": { "alias": "iconHelp"; "required": false; }; "isRequired": { "alias": "isRequired"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "isEnableClear": { "alias": "isEnableClear"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "dateSelected": "dateSelected"; "onBlurEvent": "onBlurEvent"; }, never, never, true, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litigiovirtual/ius-design-components",
-  "version": "1.0.280",
+  "version": "1.0.282",
   "peerDependencies": {
     "@angular/cdk": ">=17.0.0 <20.0.0",
     "@angular/common": ">=17.0.0 <20.0.0",
@@ -23,6 +23,12 @@
       "esm2022": "./esm2022/litigiovirtual-ius-design-components.mjs",
       "esm": "./esm2022/litigiovirtual-ius-design-components.mjs",
       "default": "./fesm2022/litigiovirtual-ius-design-components.mjs"
+    },
+    "./utils": {
+      "types": "./utils/index.d.ts",
+      "esm2022": "./esm2022/utils/litigiovirtual-ius-design-components-utils.mjs",
+      "esm": "./esm2022/utils/litigiovirtual-ius-design-components-utils.mjs",
+      "default": "./fesm2022/litigiovirtual-ius-design-components-utils.mjs"
     }
   }
 }

package/utils/currency-format.pipe.d.ts

@@ -0,0 +1,29 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Parsea lo que el usuario escribe en un input de moneda (es-CO: punto = miles, coma = decimal).
+ *  - rawStr: string con punto decimal para cálculos JS ("150000.50")
+ *  - intPart: parte entera sin formato ("150000")
+ *  - decPart: parte decimal tal como la escribió el usuario ("50") o null si no hay coma
+ */
+export declare function parseCurrencyInput(display: string): {
+    rawStr: string;
+    intPart: string;
+    decPart: string | null;
+};
+/**
+ * Formatea la parte entera con separadores de miles (es-CO) y conserva la decimal
+ * exactamente como la escribió el usuario (sin redondear). Para actualizar el display al escribir.
+ */
+export declare function buildCurrencyDisplay(intPart: string, decPart: string | null): string;
+/**
+ * Formatea el valor raw al salir del campo (blur): completa decimales si los hay.
+ *   formatCurrencyOnBlur('150000.5')  → "150.000,50"
+ *   formatCurrencyOnBlur('150000')    → "150.000"
+ */
+export declare function formatCurrencyOnBlur(rawValue: string): string;
+export declare class CurrencyFormatPipe implements PipeTransform {
+    transform(value: number | string | null | undefined, showSymbol?: boolean, currencyCode?: string, locale?: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CurrencyFormatPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<CurrencyFormatPipe, "currencyFormat", true>;
+}

package/utils/date-format.util.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Helpers de fecha/hora para inputs Angular ↔ backend (DateOnly / TimeOnly de C#).
+ *
+ * IMPORTANTE: se usa SIEMPRE el constructor local Date(y, m, d) para evitar el shift de
+ * zona horaria. new Date('yyyy-MM-dd') se interpreta como UTC y puede saltar un día según
+ * la zona; estos helpers reconstruyen la fecha desde sus componentes (hora local).
+ */
+/**
+ * Convierte cualquier valor de fecha (string "yyyy-MM-dd", "yyyy-MM-ddTHH:mm:ss" o Date)
+ * a Date en hora LOCAL. Devuelve undefined si es vacío/ inválido.
+ */
+export declare function parseLocalDate(value: any): Date | undefined;
+/** Parsea evento de date-picker (ISO string, Date, "YYYY-MM-DD") a Date local. */
+export declare function parseDateEvent(event: any): Date | undefined;
+/** Parsea evento de time-picker a string "HH:mm:ss". */
+export declare function parseHoraEvent(event: any): string | undefined;
+/** Date -> "yyyy-MM-dd" en hora local (formato DateOnly C#). */
+export declare function toDateOnlyString(d: Date): string;
+/** Date -> "HH:mm:ss" en hora local (formato TimeOnly C#). */
+export declare function toTimeOnlyString(d: Date): string;

package/utils/file-mime.util.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Infiere el MIME type a partir de la extensión del nombre de archivo.
+ *
+ * Útil cuando el backend devuelve el nombre del archivo pero no su MIME type, y la UI
+ * necesita uno para decidir ícono/visor (ej. distinguir PDF de Word/Excel/imagen).
+ * Para archivos NUEVOS subidos por el usuario, usar `File.type` (ya viene del navegador).
+ */
+export declare function inferMimeTypeFromName(fileName?: string): string;

package/utils/file-size.util.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Constantes y conversión de tamaño de archivo. Centraliza los números mágicos
+ * (1024) y ofrece una conversión a MB para mostrar totales agregados en UI.
+ */
+export declare const KB_IN_BYTES = 1024;
+export declare const MB_IN_BYTES: number;
+/** Bytes -> MB (1 decimal). Para mostrar totales agregados (ej. "X MB de 25 MB"). */
+export declare function bytesToMB(bytes: number): number;

package/utils/formato-hora.pipe.d.ts

@@ -0,0 +1,14 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Muestra una hora en formato 12h con am/pm.
+ *   {{ '14:30:00' | formatoHora }}  → "2:30 pm"
+ *   {{ '09:00'    | formatoHora }}  → "9 am"
+ * Acepta string (con HH:mm[:ss] en cualquier parte), Date o ISO.
+ */
+export declare class FormatoHoraPipe implements PipeTransform {
+    transform(value?: string | Date | null): string;
+    private formatHours;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormatoHoraPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<FormatoHoraPipe, "formatoHora", true>;
+}

package/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="@litigiovirtual/ius-design-components/utils" />
+export * from './public-api';

package/utils/public-api.d.ts

@@ -0,0 +1,5 @@
+export * from './currency-format.pipe';
+export * from './formato-hora.pipe';
+export * from './date-format.util';
+export * from './file-mime.util';
+export * from './file-size.util';