@seniorsistemas/components-ai 2.4.0 → 2.4.1

package/lib/components/dynamic-form/fields/dynamic-field-date.component.d.ts

@@ -4,6 +4,13 @@ import { TranslationService } from '../../../services/translation.service';
 import { LocaleService } from '../../../services/locale.service';
 import { DynamicFieldBaseComponent } from './dynamic-field-base.component';
 import * as i0 from "@angular/core";
+/**
+ * DynamicFieldDateComponent
+ *
+ * O FormControl.value SEMPRE armazena a data no formato ISO: "yyyy-MM-dd" (ex: "2026-05-18").
+ * A variável `displayValue` mantém o valor formatado no locale do usuário para exibição no input.
+ * Isso garante que qualquer componente que acesse form.value receba o valor pronto para o backend.
+ */
 export declare class DynamicFieldDateComponent extends DynamicFieldBaseComponent implements OnInit, OnDestroy {
     private localeService;
     private cdr;
@@ -11,20 +18,45 @@ export declare class DynamicFieldDateComponent extends DynamicFieldBaseComponent
     currentDateFormat: string;
     dateMask: string;
     calendarValue: Date | null;
+    /** Valor de exibição no formato locale (ex: "18/05/2026" para pt-BR) */
+    displayValue: string | null;
+    /** Controla a renderização do p-calendar (só existe no DOM quando necessário) */
+    showCalendar: boolean;
     private langSub?;
     private valueSub?;
     private currentLocale;
+    private updatingFromControl;
     constructor(translationService: TranslationService, localeService: LocaleService, cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnDestroy(): void;
-    private initializeValue;
+    /**
+     * Sincroniza o displayValue a partir do valor ISO do FormControl.
+     * Aceita: "yyyy-MM-dd", Date, locale string "dd/MM/yyyy", ou null.
+     */
+    private syncDisplayFromControl;
+    /** Chamado quando o usuário completa a digitação da máscara */
+    onDisplayValueComplete(): void;
+    /** Chamado quando o input perde foco */
+    onDisplayValueBlur(): void;
+    /**
+     * Converte o displayValue (locale) para ISO e seta no FormControl.
+     */
+    private syncControlFromDisplay;
+    /** Seta o valor no control sem disparar o subscriber interno */
+    private setControlValue;
+    /** Converte ISO "yyyy-MM-dd" para locale string */
+    private isoToLocale;
+    /** Converte locale string para ISO "yyyy-MM-dd" */
+    private localeToIso;
+    /** Converte Date para ISO "yyyy-MM-dd" */
+    private dateToIso;
+    /** Converte locale string para Date */
+    private localeToDate;
     private updateDateFormat;
-    private convertValueToNewLocale;
-    private dateToString;
-    private stringToDate;
     toggleCalendar(event: Event): void;
     onCalendarSelect(date: Date): void;
     onCalendarClear(): void;
+    isControlDisabled(): boolean;
     getPlaceholder(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicFieldDateComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DynamicFieldDateComponent, "sia-dynamic-field-date", never, {}, {}, never, never, true, never>;

package/lib/components/dynamic-form/fields/dynamic-field-datetime.component.d.ts

@@ -4,6 +4,13 @@ import { TranslationService } from '../../../services/translation.service';
 import { LocaleService } from '../../../services/locale.service';
 import { DynamicFieldBaseComponent } from './dynamic-field-base.component';
 import * as i0 from "@angular/core";
+/**
+ * DynamicFieldDatetimeComponent
+ *
+ * O FormControl.value SEMPRE armazena o datetime no formato ISO: "yyyy-MM-ddTHH:mm:ss.sssZ".
+ * A variável `displayValue` mantém o valor formatado no locale do usuário para exibição no input.
+ * Isso garante que qualquer componente que acesse form.value receba o valor pronto para o backend.
+ */
 export declare class DynamicFieldDatetimeComponent extends DynamicFieldBaseComponent implements OnInit, OnDestroy {
     private localeService;
     private cdr;
@@ -11,20 +18,43 @@ export declare class DynamicFieldDatetimeComponent extends DynamicFieldBaseCompo
     currentDateFormat: string;
     datetimeMask: string;
     calendarValue: Date | null;
+    /** Valor de exibição no formato locale (ex: "18/05/2026 14:30" para pt-BR) */
+    displayValue: string | null;
+    /** Controla a renderização do p-calendar (só existe no DOM quando necessário) */
+    showCalendar: boolean;
     private langSub?;
     private valueSub?;
     private currentLocale;
+    private updatingFromControl;
     constructor(translationService: TranslationService, localeService: LocaleService, cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnDestroy(): void;
-    private initializeValue;
+    /**
+     * Sincroniza o displayValue a partir do valor ISO do FormControl.
+     * Aceita: ISO string, Date, locale string, ou null.
+     */
+    private syncDisplayFromControl;
+    /** Chamado quando o usuário completa a digitação da máscara */
+    onDisplayValueComplete(): void;
+    /** Chamado quando o input perde foco */
+    onDisplayValueBlur(): void;
+    /**
+     * Converte o displayValue (locale) para ISO e seta no FormControl.
+     */
+    private syncControlFromDisplay;
+    /** Seta o valor no control sem disparar o subscriber interno */
+    private setControlValue;
+    /** Converte Date para locale display string */
+    private isoToLocale;
+    /** Converte locale string para ISO datetime string */
+    private localeToIso;
+    /** Converte locale string para Date */
+    private localeToDate;
     private updateDatetimeFormat;
-    private convertValueToNewLocale;
-    private dateToString;
-    private stringToDate;
     toggleCalendar(event: Event): void;
     onCalendarSelect(date: Date): void;
     onCalendarClear(): void;
+    isControlDisabled(): boolean;
     getPlaceholder(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicFieldDatetimeComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DynamicFieldDatetimeComponent, "sia-dynamic-field-datetime", never, {}, {}, never, never, true, never>;

package/lib/components/dynamic-form/fields/dynamic-field-time.component.d.ts

@@ -3,17 +3,45 @@ import { Calendar } from 'primeng/calendar';
 import { TranslationService } from '../../../services/translation.service';
 import { DynamicFieldBaseComponent } from './dynamic-field-base.component';
 import * as i0 from "@angular/core";
+/**
+ * DynamicFieldTimeComponent
+ *
+ * O FormControl.value armazena o horário no formato "HH:mm" (ex: "14:30").
+ * A variável `displayValue` mantém o valor formatado para exibição no input.
+ * Aceita valores de entrada em "HH:mm" ou "HH:mm:ss" (truncando os segundos).
+ */
 export declare class DynamicFieldTimeComponent extends DynamicFieldBaseComponent implements OnInit, OnDestroy {
     timePicker: Calendar;
-    timeValue: Date | null;
+    /** Valor de exibição "HH:mm" */
+    displayValue: string | null;
+    /** Valor do picker (Date) */
+    pickerValue: Date | null;
+    /** Controla a renderização do p-calendar */
+    showPicker: boolean;
     private valueSub?;
+    private updatingFromControl;
     constructor(translationService: TranslationService);
     ngOnInit(): void;
     ngOnDestroy(): void;
+    /**
+     * Sincroniza o displayValue a partir do valor do FormControl.
+     * Aceita: "HH:mm", "HH:mm:ss", Date, ou null.
+     */
+    private syncDisplayFromControl;
+    /** Chamado quando o usuário completa a digitação da máscara */
+    onDisplayValueComplete(): void;
+    /** Chamado quando o input perde foco */
+    onDisplayValueBlur(): void;
+    /** Converte o displayValue para o FormControl */
+    private syncControlFromDisplay;
+    /** Seta o valor no control sem disparar o subscriber interno */
+    private setControlValue;
     private dateToTimeString;
-    private stringToDate;
+    private timeStringToDate;
+    private isValidTime;
     toggleTimePicker(event: Event): void;
     onTimeSelect(date: Date): void;
+    isControlDisabled(): boolean;
     getPlaceholder(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicFieldTimeComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DynamicFieldTimeComponent, "sia-dynamic-field-time", never, {}, {}, never, never, true, never>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seniorsistemas/components-ai",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Biblioteca de componentes reutilizáveis com IA para aplicações Angular da Senior Sistemas",
   "keywords": [
     "angular",