@seniorsistemas/components-ai 2.3.0 → 2.4.0-master-bdd92d4e

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,43 @@ 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;
     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,41 @@ 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;
     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 SEMPRE armazena o horário no formato ISO: "HH:mm:ss" (ex: "14:30:00").
+ * A variável `displayValue` mantém o valor formatado "HH:mm" para exibição no input.
+ * Isso garante que qualquer componente que acesse form.value receba o valor pronto para o backend.
+ */
 export declare class DynamicFieldTimeComponent extends DynamicFieldBaseComponent implements OnInit, OnDestroy {
     timePicker: Calendar;
     timeValue: Date | null;
+    /** Valor de exibição no formato "HH:mm" */
+    displayValue: string | null;
     private valueSub?;
+    private updatingFromControl;
     constructor(translationService: TranslationService);
     ngOnInit(): void;
     ngOnDestroy(): void;
-    private dateToTimeString;
-    private stringToDate;
+    /**
+     * Sincroniza o displayValue a partir do valor ISO do FormControl.
+     * Aceita: "HH:mm:ss", "HH:mm", 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 ("HH:mm") para ISO ("HH:mm:ss") e seta no FormControl.
+     */
+    private syncControlFromDisplay;
+    /** Seta o valor no control sem disparar o subscriber interno */
+    private setControlValue;
+    /** Converte Date para ISO "HH:mm:ss" */
+    private dateToIso;
+    /** Converte display "HH:mm" para Date */
+    private displayToDate;
     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/lib/components/steps/steps.component.d.ts

@@ -0,0 +1,63 @@
+import { EventEmitter, OnChanges, SimpleChanges, ElementRef, AfterViewInit, OnDestroy, ChangeDetectorRef } from '@angular/core';
+import * as i0 from "@angular/core";
+export interface StepItem {
+    id?: string;
+    label: string;
+    icon?: string;
+    styleClass?: string;
+    disabled?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export declare class StepsComponent implements OnChanges, AfterViewInit, OnDestroy {
+    private cdr;
+    /** Lista de steps a serem exibidos */
+    steps: StepItem[];
+    /** Índice do step ativo */
+    activeIndex: number;
+    /** Se permite clicar nos steps para navegar */
+    readonly: boolean;
+    /** Quantidade máxima de steps visíveis. 'auto' calcula com base no container */
+    maxVisible: number | 'auto';
+    /** Largura mínima de cada step em pixels (usado no cálculo automático) */
+    stepMinWidth: number;
+    /** Se mostra animação de transição ao navegar */
+    animated: boolean;
+    /** Modo de navegação das setas: 'step' altera o activeIndex, 'scroll' apenas desloca a janela visível */
+    navigationMode: 'step' | 'scroll';
+    /** Esquema de cores aplicado aos steps. Altera as cores do ativo e completados */
+    colorScheme: 'default' | 'success' | 'danger' | 'warning' | 'info';
+    /** Classe CSS customizada para o wrapper */
+    styleClass: string;
+    /** Emite quando o activeIndex muda por clique */
+    activeIndexChange: EventEmitter<number>;
+    /** Emite o StepItem clicado */
+    stepClick: EventEmitter<StepItem>;
+    stepsContainer: ElementRef<HTMLElement>;
+    visibleSteps: StepItem[];
+    visibleStartIndex: number;
+    visibleEndIndex: number;
+    hasOverflowLeft: boolean;
+    hasOverflowRight: boolean;
+    calculatedMaxVisible: number;
+    private resizeObserver;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnChanges(changes: SimpleChanges): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    onStepClick(step: StepItem, visibleIndex: number): void;
+    navigateLeft(): void;
+    navigateRight(): void;
+    /** Desloca a janela visível para um novo startIndex sem alterar o activeIndex */
+    private scrollWindow;
+    getStepState(visibleIndex: number): 'completed' | 'active' | 'pending';
+    getRealIndex(visibleIndex: number): number;
+    get hiddenLeftCount(): number;
+    get hiddenRightCount(): number;
+    trackByIndex(index: number): number;
+    private setupResizeObserver;
+    private recalculate;
+    private getMaxVisible;
+    private calculateVisibleWindow;
+    static ɵfac: i0.ɵɵFactoryDeclaration<StepsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<StepsComponent, "sia-steps", never, { "steps": { "alias": "steps"; "required": false; }; "activeIndex": { "alias": "activeIndex"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "maxVisible": { "alias": "maxVisible"; "required": false; }; "stepMinWidth": { "alias": "stepMinWidth"; "required": false; }; "animated": { "alias": "animated"; "required": false; }; "navigationMode": { "alias": "navigationMode"; "required": false; }; "colorScheme": { "alias": "colorScheme"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; }, { "activeIndexChange": "activeIndexChange"; "stepClick": "stepClick"; }, never, never, true, never>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seniorsistemas/components-ai",
-  "version": "2.3.0",
+  "version": "2.4.0-master-bdd92d4e",
   "description": "Biblioteca de componentes reutilizáveis com IA para aplicações Angular da Senior Sistemas",
   "keywords": [
     "angular",
@@ -51,4 +51,4 @@
       "default": "./fesm2022/seniorsistemas-components-ai.mjs"
     }
   }
-}
+}

package/public-api.d.ts

@@ -16,6 +16,7 @@ export { LoadingComponent } from './lib/components/loading/loading.component';
 export { IassistIconComponent } from './lib/components/loading/iassist-icon.component';
 export { EntityListBaseComponent } from './lib/components/base/entity-list-base.component';
 export { KanbanBoardComponent, type KanbanColumn, type KanbanItem, type KanbanTag, type KanbanDropEvent } from './lib/components/kanban-board/kanban-board.component';
+export { StepsComponent, type StepItem } from './lib/components/steps/steps.component';
 export { DynamicFormComponent } from './lib/components/dynamic-form/dynamic-form.component';
 export * from './lib/components/dynamic-form/models/dynamic-form.models';
 export * from './lib/components/dynamic-form/fields';