@po-ui/ng-components 21.8.0 → 21.10.0

package/lib/components/index.d.ts

@@ -50,3 +50,4 @@ export * from './po-search/index';
 export * from './po-skeleton/index';
 export * from './po-toaster/index';
 export * from './po-header/index';
+export * from './po-timer/index';

package/lib/components/po-avatar/po-avatar.component.d.ts

@@ -18,6 +18,7 @@ import { PoAvatarBaseComponent } from './po-avatar-base.component';
  * <example name="po-avatar-business-card" title="PO Avatar - Business Card" >
  *  <file name="sample-po-avatar-business-card/sample-po-avatar-business-card.component.html"> </file>
  *  <file name="sample-po-avatar-business-card/sample-po-avatar-business-card.component.ts"> </file>
+ *  <file name="sample-po-avatar-business-card/sample-po-avatar-business-card.component.css"> </file>
  * </example>
  */
 export declare class PoAvatarComponent extends PoAvatarBaseComponent implements OnInit {

package/lib/components/po-badge/po-badge-base.component.d.ts

@@ -45,6 +45,21 @@ export declare class PoBadgeBaseComponent {
      *   - <span class="dot po-color-11"></span> `color-11`
      *   - <span class="dot po-color-12"></span> `color-12`
      *
+     * > Também é possível utilizar as 35 cores da paleta **Caption Tag Colors**:
+     *
+     *   - <span class="dot po-caption-tag-01"></span> `caption-tag-01` <span class="dot po-caption-tag-02"></span> `caption-tag-02` <span class="dot po-caption-tag-03"></span> `caption-tag-03` <span class="dot po-caption-tag-04"></span> `caption-tag-04` <span class="dot po-caption-tag-05"></span> `caption-tag-05`
+     *   - <span class="dot po-caption-tag-06"></span> `caption-tag-06` <span class="dot po-caption-tag-07"></span> `caption-tag-07` <span class="dot po-caption-tag-08"></span> `caption-tag-08` <span class="dot po-caption-tag-09"></span> `caption-tag-09` <span class="dot po-caption-tag-10"></span> `caption-tag-10`
+     *   - <span class="dot po-caption-tag-11"></span> `caption-tag-11` <span class="dot po-caption-tag-12"></span> `caption-tag-12` <span class="dot po-caption-tag-13"></span> `caption-tag-13` <span class="dot po-caption-tag-14"></span> `caption-tag-14` <span class="dot po-caption-tag-15"></span> `caption-tag-15`
+     *   - <span class="dot po-caption-tag-16"></span> `caption-tag-16` <span class="dot po-caption-tag-17"></span> `caption-tag-17` <span class="dot po-caption-tag-18"></span> `caption-tag-18` <span class="dot po-caption-tag-19"></span> `caption-tag-19` <span class="dot po-caption-tag-20"></span> `caption-tag-20`
+     *   - <span class="dot po-caption-tag-21"></span> `caption-tag-21` <span class="dot po-caption-tag-22"></span> `caption-tag-22` <span class="dot po-caption-tag-23"></span> `caption-tag-23` <span class="dot po-caption-tag-24"></span> `caption-tag-24` <span class="dot po-caption-tag-25"></span> `caption-tag-25`
+     *   - <span class="dot po-caption-tag-26"></span> `caption-tag-26` <span class="dot po-caption-tag-27"></span> `caption-tag-27` <span class="dot po-caption-tag-28"></span> `caption-tag-28` <span class="dot po-caption-tag-29"></span> `caption-tag-29` <span class="dot po-caption-tag-30"></span> `caption-tag-30`
+     *   - <span class="dot po-caption-tag-31"></span> `caption-tag-31` <span class="dot po-caption-tag-32"></span> `caption-tag-32` <span class="dot po-caption-tag-33"></span> `caption-tag-33` <span class="dot po-caption-tag-34"></span> `caption-tag-34` <span class="dot po-caption-tag-35"></span> `caption-tag-35`
+     *
+     * Exemplo de uso:
+     * ```
+     * <po-badge p-color="caption-tag-13" p-value="5"></po-badge>
+     * ```
+     *
      * @default `color-07`
      */
     set color(value: string);

package/lib/components/po-button/po-button-base.component.d.ts

@@ -181,6 +181,16 @@ export declare class PoButtonBaseComponent {
      */
     readonly ariaLabel: import("@angular/core").InputSignal<string>;
     ariaExpanded?: boolean;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o `tabindex` do elemento `<button>` nativo interno.
+     *
+     * Use `[tabindex]="-1"` para remover o botão da ordem de foco do teclado.
+     */
+    tabindex?: number | string;
     /**
      * @optional
      *

package/lib/components/po-calendar/constants/po-calendar-range-presets.constant.d.ts

@@ -0,0 +1,2 @@
+import { PoCalendarRangePreset } from '../interfaces/po-calendar-range-preset.interface';
+export declare const PO_CALENDAR_DEFAULT_RANGE_PRESETS: Array<PoCalendarRangePreset>;

package/lib/components/po-calendar/index.d.ts

@@ -1,3 +1,5 @@
 export * from './po-calendar-mode.enum';
 export * from './po-calendar.component';
 export * from './po-calendar.module';
+export * from './interfaces/po-calendar-range-preset.interface';
+export * from './constants/po-calendar-range-presets.constant';

package/lib/components/po-calendar/interfaces/po-calendar-range-preset.interface.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Interface para definir um preset de intervalo de datas no calendário.
+ *
+ * Cada preset possui um rótulo identificador e uma função que calcula
+ * dinamicamente o intervalo de datas com base na data atual.
+ */
+export interface PoCalendarRangePreset {
+    /** Identificador/rótulo de exibição do preset. */
+    label: string;
+    /** Função que calcula dinamicamente o intervalo de datas relativo à data informada. */
+    dateRange: (today: Date) => {
+        start: Date;
+        end: Date;
+    };
+    isDisabled?: boolean;
+}

package/lib/components/po-calendar/po-calendar-base.component.d.ts

@@ -2,6 +2,7 @@ import { EventEmitter, TemplateRef } from '@angular/core';
 import { PoDateService } from '../../services/po-date';
 import { PoLanguageService } from '../../services/po-language/po-language.service';
 import { PoCalendarMode } from './po-calendar-mode.enum';
+import { PoCalendarRangePreset } from './interfaces/po-calendar-range-preset.interface';
 /**
  * @description
  *
@@ -118,6 +119,7 @@ export declare class PoCalendarBaseComponent {
     changeMonthYear: EventEmitter<any>;
     close: EventEmitter<void>;
     activateDate: any;
+    selectedPresetLabel: string | null;
     value: any;
     protected onTouched: any;
     protected propagateChange: any;
@@ -206,6 +208,57 @@ export declare class PoCalendarBaseComponent {
     get mode(): PoCalendarMode;
     get isRange(): boolean;
     headerTemplate?: TemplateRef<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Habilita a exibição dos presets padrão de intervalos de data no painel lateral do calendário em modo *range*.
+     *
+     * Aceita os seguintes valores:
+     * - `true`: exibe todos os presets padrão (Amanhã, Hoje, Ontem, Últimos 7 dias, Últimos 14 dias, Últimos 30 dias, Últimos 3 meses, Últimos 6 meses).
+     * - `false`: não exibe os presets padrão.
+     * - `Array<string>`: exibe apenas os presets padrão cujos labels estejam no array informado.
+     *   O preset "today" é obrigatório e será incluído automaticamente mesmo que não esteja no array.
+     *
+     * Caso `p-range-preset-options` também seja informado, os presets customizados serão exibidos junto aos presets padrão,
+     * ordenados automaticamente por temporalidade com base na data início (Futuro → Presente → Passado).
+     *
+     * @default `false`
+     */
+    set rangePresets(value: boolean | Array<string> | string);
+    get rangePresets(): boolean | Array<string>;
+    private _rangePresets;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Lista de presets customizados de intervalos de data exibidos no painel lateral do calendário em modo *range*.
+     *
+     * Quando informado sem `p-range-presets`, exibe apenas os presets customizados.
+     * Quando informado junto com `p-range-presets` habilitado, os presets customizados serão exibidos junto aos presets padrão,
+     * ordenados automaticamente por temporalidade com base na data início (Futuro → Presente → Passado).
+     *
+     * Para utilizar presets customizados, informe um array de objetos que implementam a interface `PoCalendarRangePreset`.
+     */
+    rangePresetOptions?: Array<PoCalendarRangePreset>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define a ordenação dos presets na lista.
+     *
+     * Valores aceitos:
+     * - `'asc'` (padrão): presets mais próximos de hoje aparecem primeiro.
+     * - `'desc'`: presets mais distantes de hoje aparecem primeiro.
+     *
+     * A ordenação é aplicada dentro de cada grupo de temporalidade com base na data início (Futuro → Presente → Passado).
+     *
+     * @default `asc`
+     */
+    rangePresetsOrder: 'asc' | 'desc';
     /**
      * @optional
      *
@@ -220,6 +273,7 @@ export declare class PoCalendarBaseComponent {
      */
     set size(value: string);
     get size(): string;
+    widthWithPresets?: boolean;
     constructor(poDate: PoDateService, languageService: PoLanguageService);
     protected onThemeChange(): void;
     protected setActivateDate(date?: Date | string): void;

package/lib/components/po-calendar/po-calendar-footer/po-calendar-footer.component.d.ts

@@ -0,0 +1,16 @@
+import { EventEmitter } from '@angular/core';
+export declare class PoCalendarFooterComponent {
+    size: string;
+    labelClear: string;
+    labelToday: string;
+    responsive: boolean;
+    todayDisabled: boolean;
+    hideTodayButton: boolean;
+    clear: EventEmitter<void>;
+    selectToday: EventEmitter<void>;
+    closeCalendar: EventEmitter<void>;
+    onClear(): void;
+    onSelectToday(): void;
+    onClearKeydown(event: KeyboardEvent): void;
+    onTodayKeydown(event: KeyboardEvent): void;
+}

package/lib/components/po-calendar/po-calendar-preset-list/po-calendar-preset-list.component.d.ts

@@ -0,0 +1,28 @@
+import { EventEmitter, QueryList } from '@angular/core';
+import { PoCalendarRangePreset } from '../interfaces/po-calendar-range-preset.interface';
+export declare class PoCalendarPresetListComponent {
+    private readonly poCalendarLangService;
+    private _locale;
+    size: string;
+    presets: Array<PoCalendarRangePreset>;
+    selectedPreset: string | null;
+    responsive: boolean;
+    set locale(value: string);
+    get locale(): string;
+    closeCalendar: EventEmitter<void>;
+    selectPreset: EventEmitter<{
+        label: string;
+        start: Date;
+        end: Date;
+    }>;
+    presetButtons: QueryList<HTMLButtonElement>;
+    focusedIndex: number;
+    getDisplayLabel(preset: PoCalendarRangePreset): string;
+    isSelected(preset: PoCalendarRangePreset): boolean;
+    onKeydown(event: KeyboardEvent, index: number): void;
+    resetFocusToFirst(): void;
+    isPresetDisabled(preset: PoCalendarRangePreset): boolean;
+    onPresetClick(preset: PoCalendarRangePreset): void;
+    private focusPreset;
+    private getPresetButtons;
+}

package/lib/components/po-calendar/po-calendar-wrapper/po-calendar-wrapper.component.d.ts

@@ -17,6 +17,8 @@ export declare class PoCalendarWrapperComponent implements OnInit, OnChanges {
     maxDate: any;
     hoverValue: Date;
     size: string;
+    hideTodayButton: boolean;
+    hasPresets: boolean;
     headerTemplate?: TemplateRef<any>;
     private _locale;
     set locale(value: string);
@@ -72,6 +74,12 @@ export declare class PoCalendarWrapperComponent implements OnInit, OnChanges {
     private updateTemplateContext;
     updateDate(year: number, month: number, comboComponent?: any): void;
     onComboBlur(comboComponent?: any): void;
+    private handleComboBlur;
+    private syncInputValue;
+    private applySelectedValue;
+    private ensureValidDisplay;
+    private isMonthInvalid;
+    private isYearInvalid;
     private updateDisplay;
     private setInitialFocusedDay;
     private ensureValidFocusedDay;
@@ -86,11 +94,9 @@ export declare class PoCalendarWrapperComponent implements OnInit, OnChanges {
     onMouseEnter(day: any): void;
     onMouseLeave(): void;
     onSelectToday(): void;
-    onTodayKeydown(event: KeyboardEvent): void;
+    onFooterCloseCalendar(): void;
     onHostKeydown(event: KeyboardEvent): void;
     private restoreOriginalDisplay;
-    onTodayKeydownEnter(event: KeyboardEvent): void;
-    onTodayKeydownSpace(event: KeyboardEvent): void;
     onDayKeydown(event: KeyboardEvent, day: Date, index: number): void;
     private isSelectionKey;
     private handleSelectKey;

package/lib/components/po-calendar/po-calendar.component.d.ts

@@ -1,6 +1,7 @@
-import { OnChanges, OnInit, SimpleChanges } from '@angular/core';
+import { DoCheck, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoCalendarBaseComponent } from './po-calendar-base.component';
+import { PoCalendarRangePreset } from './interfaces/po-calendar-range-preset.interface';
 /**
  * @docsExtends PoCalendarBaseComponent
  *
@@ -11,6 +12,11 @@ import { PoCalendarBaseComponent } from './po-calendar-base.component';
  *  <file name="sample-po-calendar-basic/sample-po-calendar-basic.component.ts"> </file>
  * </example>
  *
+ * <example name="po-calendar-range-presets" title="PO Calendar - Range and Presets" >
+ *  <file name="sample-po-calendar-range-presets/sample-po-calendar-range-presets.component.html"> </file>
+ *  <file name="sample-po-calendar-range-presets/sample-po-calendar-range-presets.component.ts"> </file>
+ * </example>
+ *
  * <example name="po-calendar-labs" title="PO Calendar Labs" >
  *  <file name="sample-po-calendar-labs/sample-po-calendar-labs.component.html"> </file>
  *  <file name="sample-po-calendar-labs/sample-po-calendar-labs.component.ts"> </file>
@@ -21,13 +27,23 @@ import { PoCalendarBaseComponent } from './po-calendar-base.component';
  *  <file name="sample-po-calendar-ticket-sales/sample-po-calendar-ticket-sales.component.ts"> </file>
  * </example>
  */
-export declare class PoCalendarComponent extends PoCalendarBaseComponent implements OnInit, OnChanges {
+export declare class PoCalendarComponent extends PoCalendarBaseComponent implements OnInit, OnChanges, DoCheck {
     private readonly changeDetector;
+    private readonly poCalendarLangService;
     hoverValue: Date;
+    displayToClean: string;
+    private readonly _isRange;
+    private readonly _rangePresetsValue;
+    private readonly _rangePresetOptionsValue;
+    private readonly _rangePresetsOrderValue;
+    private readonly _minDateValue;
+    private readonly _maxDateValue;
+    readonly effectivePresets: import("@angular/core").Signal<PoCalendarRangePreset[]>;
     constructor();
-    get isResponsive(): boolean;
+    get isResponsive(): RegExpMatchArray;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    ngDoCheck(): void;
     getActivateDate(partType: any): any;
     getValue(partType: any): any;
     onSelectDate(selectedDate: any, partType?: any): void;
@@ -43,6 +59,15 @@ export declare class PoCalendarComponent extends PoCalendarBaseComponent impleme
         [key: string]: any;
     };
     writeValue(value: any): void;
+    onPresetSelected(event: {
+        label: string;
+        start: Date;
+        end: Date;
+    }): void;
+    private sortPresetsByTemporality;
+    private normalizeDate;
+    private enrichPresetsWithDisabledState;
+    private clampDate;
     private getValidateStartDate;
     private getValueFromSelectedDate;
     private updateActivateDateFromHeaderChange;

package/lib/components/po-calendar/services/po-calendar.lang.service.d.ts

@@ -13,6 +13,7 @@ export declare class PoCalendarLangService {
         es: string;
         ru: string;
     };
+    private readonly presetLabels;
     getMonth(month: number): any;
     getMonthLabel(): any;
     getMonthsArray(): any[];
@@ -23,5 +24,6 @@ export declare class PoCalendarLangService {
     getPreviousMonthLabel(): any;
     getNextMonthLabel(): any;
     getToCleanLabel(): any;
+    getPresetLabel(key: string): string;
     setLanguage(language: string): void;
 }

package/lib/components/po-container/po-container.component.d.ts

@@ -17,6 +17,7 @@ import { PoContainerBaseComponent } from './po-container-base.component';
  * <example name="po-container-dashboard" title="PO Container - Dashboard">
  *  <file name="sample-po-container-dashboard/sample-po-container-dashboard.component.html"> </file>
  *  <file name="sample-po-container-dashboard/sample-po-container-dashboard.component.ts"> </file>
+ *  <file name="sample-po-container-dashboard/sample-po-container-dashboard.component.css"> </file>
  *  <file name="sample-po-container-dashboard/sample-po-container-dashboard.service.ts"> </file>
  * </example>
  */

package/lib/components/po-dynamic/po-dynamic-form/interfaces/po-dynamic-form-field.interface.d.ts

@@ -1,5 +1,5 @@
 import { TemplateRef } from '@angular/core';
-import { ErrorAsyncProperties, PoCheckboxGroupOption, PoComboFilter, PoComboLiterals, PoDatepickerIsoFormat, PoDatepickerRangeLiterals, PoLookupFilter, PoLookupLiterals, PoMultiselectFilter, PoMultiselectFilterMode, PoMultiselectLiterals, PoSwitchLabelPosition, PoUploadFile, PoUploadFileRestrictions, PoUploadLiterals } from '../../../po-field';
+import { ErrorAsyncProperties, PoCheckboxGroupOption, PoComboFilter, PoComboLiterals, PoDatepickerIsoFormat, PoDatepickerRangeLiterals, PoTimepickerModelFormat, PoLookupFilter, PoLookupLiterals, PoMultiselectFilter, PoMultiselectFilterMode, PoMultiselectLiterals, PoSwitchLabelPosition, PoUploadFile, PoUploadFileRestrictions, PoUploadLiterals } from '../../../po-field';
 import { PoLookupAdvancedFilter } from '../../../po-field/po-lookup/interfaces/po-lookup-advanced-filter.interface';
 import { PoLookupColumn } from '../../../po-field/po-lookup/interfaces/po-lookup-column.interface';
 import { PoMultiselectOption } from '../../../po-field/po-multiselect/interfaces/po-multiselect-option.interface';
@@ -214,15 +214,29 @@ export interface PoDynamicFormField extends PoDynamicField {
      */
     listboxControlPosition?: 'top' | 'bottom';
     /**
-     * Valor máximo a ser informado no componente, podendo ser utilizado quando o tipo de dado por *number*, *date* ou *dateTime*.
+     * Habilita um estado de carregamento no componente, desabilitando-o e exibindo um ícone de carregamento.
      *
-     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-number`, `po-decimal`
+     * > Por padrão é `false`.
+     *
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-number`, `po-decimal`,
+     * `po-input`, `po-select`, `po-switch`, `po-combo`, `po-lookup`, `po-multiselect`,
+     * `po-textarea`, `po-password`, `po-upload`.
+     */
+    loading?: boolean;
+    /**
+     * Valor máximo a ser informado no componente, podendo ser utilizado quando o tipo de dado por *number*, *date*, *dateTime* ou *time*.
+     *
+     * > Para `po-timepicker`, o valor deve estar no formato `HH:mm` ou `HH:mm:ss`.
+     *
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-number`, `po-decimal`, `po-timepicker`
      * */
     maxValue?: string | number;
     /**
-     * Valor mínimo a ser informado no componente, podendo ser utilizado quando o tipo de dado por *number*, *date* ou *dateTime*.
+     * Valor mínimo a ser informado no componente, podendo ser utilizado quando o tipo de dado por *number*, *date*, *dateTime* ou *time*.
+     *
+     * > Para `po-timepicker`, o valor deve estar no formato `HH:mm` ou `HH:mm:ss`.
      *
-     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-number`, `po-decimal`
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-number`, `po-decimal`, `po-timepicker`
      */
     minValue?: string | number;
     /** Quantidade de linhas exibidas no `po-textarea`. */
@@ -340,6 +354,11 @@ export interface PoDynamicFormField extends PoDynamicField {
      * - mm/dd/yyyy
      * - yyyy/mm/dd
      *
+     * Ao utilizar com o `type` *PoDynamicFieldType.Time*, define o formato de exibição do horário:
+     *
+     * Valores válidos:
+     * - `24`: formato de 24 horas (padrão)
+     * - `12`: formato de 12 horas com indicador AM/PM
      *
      * Também pode-se utilizar em conjunto com `searchService`, informando uma lista de propriedades que será utilizado
      * para formatação da exibição no campo, por exemplo: ["id", "name"].
@@ -447,12 +466,20 @@ export interface PoDynamicFormField extends PoDynamicField {
      * Permite esconder a função de espiar a senha digitada no `po-password`.
      */
     hidePasswordPeek?: boolean;
+    /**
+     * Define o formato do valor do horário a ser utilizado no model do `po-timepicker`.
+     *
+     * > Veja os valores válidos no `PoTimepickerModelFormat`.
+     *
+     * **Componente compatível:** `po-timepicker`
+     */
+    modelFormat?: PoTimepickerModelFormat;
     /**
      * Padrão de formatação para saída do model, independentemente do formato de entrada.
      *
-     * > Veja os valores válidos no `enumPoDatepickerIsoFormat`.
+     * > Veja os valores válidos no `PoDatepickerIsoFormat`.
      *
-     * **Componente compatível:** po-datepicker
+     * **Componente compatível:** `po-datepicker`
      */
     isoFormat?: PoDatepickerIsoFormat;
     /**
@@ -487,6 +514,30 @@ export interface PoDynamicFormField extends PoDynamicField {
      * Intervalo utilizado no `po-number`.
      */
     step?: number;
+    /**
+     * Exibe a coluna de segundos no painel do timepicker.
+     *
+     * @default `false`
+     *
+     * **Componente compatível:** `po-timepicker`
+     */
+    showSeconds?: boolean;
+    /**
+     * Define o intervalo entre os minutos exibidos no painel do timepicker.
+     *
+     * @default `5`
+     *
+     * **Componente compatível:** `po-timepicker`
+     */
+    minuteInterval?: number;
+    /**
+     * Define o intervalo entre os segundos exibidos no painel do timepicker.
+     *
+     * @default `1`
+     *
+     * **Componente compatível:** `po-timepicker`
+     */
+    secondInterval?: number;
     /**
      * Define o modo de pesquisa utilizado no filtro da lista de seleção: `startsWith`, `contains` ou `endsWith`.
      * > Quando utilizar a propriedade p-filter-service esta propriedade será ignorada.

package/lib/components/po-field/index.d.ts

@@ -12,6 +12,9 @@ export * from './po-combo/po-combo-option-template/po-combo-option-template.dire
 export * from './po-combo/po-combo.component';
 export * from './po-datepicker/enums/po-datepicker-iso-format.enum';
 export * from './po-datepicker/po-datepicker.component';
+export * from './po-timepicker/enums/po-timepicker-iso-format.enum';
+export * from './po-timepicker/po-timepicker.component';
+export * from './po-timepicker/po-timepicker.module';
 export * from './po-datepicker-range/interfaces/po-datepicker-range.interface';
 export * from './po-datepicker-range/interfaces/po-datepicker-range-literals.interface';
 export * from './po-datepicker-range/po-datepicker-range.component';

package/lib/components/po-field/po-combo/po-combo.component.d.ts

@@ -25,6 +25,7 @@ import { PoHelperComponent } from '../../po-helper';
  * <example name="po-combo-scheduling" title="PO Combo - Scheduling">
  *   <file name="sample-po-combo-scheduling/sample-po-combo-scheduling.component.html"> </file>
  *   <file name="sample-po-combo-scheduling/sample-po-combo-scheduling.component.ts"> </file>
+ *   <file name="sample-po-combo-scheduling/sample-po-combo-scheduling.component.css"> </file>
  *   <file name="sample-po-combo-scheduling/sample-po-combo-scheduling.service.ts"> </file>
  * </example>
  *

package/lib/components/po-field/po-datepicker-range/po-datepicker-range-base.component.d.ts

@@ -6,6 +6,7 @@ import { PoDateService } from './../../../services/po-date/po-date.service';
 import { PoDatepickerRangeLiterals } from './interfaces/po-datepicker-range-literals.interface';
 import { PoDatepickerRange } from './interfaces/po-datepicker-range.interface';
 import { PoHelperOptions } from '../../po-helper';
+import { PoCalendarRangePreset } from '../../po-calendar/interfaces/po-calendar-range-preset.interface';
 /**
  * @description
  *
@@ -130,6 +131,59 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      * @default `false`
      */
     compactLabel: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Habilita a exibição dos presets padrão de intervalos de data no painel lateral do calendário.
+     *
+     * Aceita os seguintes valores:
+     * - `true`: exibe todos os presets padrão (Amanhã, Hoje, Ontem, Últimos 7 dias, Últimos 14 dias, Últimos 30 dias, Últimos 3 meses, Últimos 6 meses).
+     * - `false`: não exibe os presets padrão.
+     * - `Array<string>`: exibe apenas os presets padrão cujos labels estejam no array informado.
+     * > Label dos presets: tomorrow, today, yesterday, 7days, 14days, 30days, 3months, 6months.
+     *
+     * O preset "today" é obrigatório e será incluído automaticamente mesmo que não esteja no array.
+     *
+     * Caso `p-range-preset-options` também seja informado, os presets customizados serão exibidos junto aos presets padrão,
+     * ordenados automaticamente por temporalidade com base na data início (Futuro → Presente → Passado).
+     *
+     * @default `false`
+     */
+    set rangePresets(value: boolean | Array<string> | string);
+    get rangePresets(): boolean | Array<string>;
+    private _rangePresets;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Lista de presets customizados de intervalos de data exibidos no painel lateral do calendário.
+     *
+     * Quando informado sem `p-range-presets`, exibe apenas os presets customizados.
+     * Quando informado junto com `p-range-presets` habilitado, os presets customizados serão exibidos junto aos presets padrão,
+     * ordenados automaticamente por temporalidade com base na data início (Futuro → Presente → Passado).
+     *
+     * Para utilizar presets customizados, informe um array de objetos que implementam a interface `PoCalendarRangePreset`.
+     */
+    rangePresetOptions?: Array<PoCalendarRangePreset>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define a ordenação dos presets na lista.
+     *
+     * Valores aceitos:
+     * - `'asc'` (padrão): presets mais próximos de hoje aparecem primeiro.
+     * - `'desc'`: presets mais distantes de hoje aparecem primeiro.
+     *
+     * A ordenação é aplicada dentro de cada grupo de temporalidade com base na data início (Futuro → Presente → Passado).
+     *
+     * @default `asc`
+     */
+    rangePresetsOrder: 'asc' | 'desc';
     /**
      * @optional
      *

package/lib/components/po-field/po-datepicker-range/po-datepicker-range.component.d.ts

@@ -13,6 +13,11 @@ import { PoButtonComponent } from '../../po-button';
  *  <file name="sample-po-datepicker-range-basic/sample-po-datepicker-range-basic.component.ts"> </file>
  * </example>
  *
+ * <example name="po-datepicker-range-presets" title="PO Datepicker Range - Presets">
+ *  <file name="sample-po-datepicker-range-presets/sample-po-datepicker-range-presets.component.html"> </file>
+ *  <file name="sample-po-datepicker-range-presets/sample-po-datepicker-range-presets.component.ts"> </file>
+ * </example>
+ *
  * <example name="po-datepicker-range-labs" title="PO Datepicker Range Labs">
  *  <file name="sample-po-datepicker-range-labs/sample-po-datepicker-range-labs.component.html"> </file>
  *  <file name="sample-po-datepicker-range-labs/sample-po-datepicker-range-labs.component.ts"> </file>
@@ -44,9 +49,11 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     iconClean: ElementRef<HTMLElement>;
     id: string;
     isCalendarVisible: boolean;
+    widthWithPresets: boolean;
     private clickListener;
     private eventResizeListener;
     private readonly poDatepickerRangeElement;
+    private readonly MIN_CALENDAR_WIDTH_WITH_PRESETS;
     get autocomplete(): "off" | "on";
     get enableCleaner(): boolean;
     get endDateInputName(): string;
@@ -95,6 +102,12 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     onFocus(event: any): void;
     onKeydown(event?: any): void;
     onKeyPress(event: any): void;
+    private handleShiftTabWithCleaner;
+    private handleShiftTabWithoutCleaner;
+    private handleTabWithCalendarVisible;
+    private handleMobileNavigation;
+    private handlePresetNavigation;
+    private handleComboNavigation;
     onKeydownDatepickerRange($event?: any): void;
     onKeyup(event: any): void;
     resetDateRangeInputValidation(): void;
@@ -124,6 +137,7 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
      * ```
      */
     showAdditionalHelp(): boolean;
+    enableHorizontalMouseWheel(): void;
     toggleCalendar(): void;
     updateScreenByModel(model: PoDatepickerRange): void;
     onCalendarKeyDown(event: KeyboardEvent): void;
@@ -131,6 +145,10 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
         hideAdditionalHelp: boolean;
         helperSettings?: any;
     };
+    onResize(): void;
+    private calculateWidthWithPresets;
+    private updateWidthWithPresets;
+    verifyMobile(): RegExpMatchArray;
     setCalendarPosition(): void;
     private applyFocusOnDatePickerRangeField;
     private formatDate;

package/lib/components/po-field/po-multiselect/po-multiselect.component.d.ts

@@ -33,6 +33,7 @@ import { PoHelperComponent } from '../../po-helper';
  * <example name="po-multiselect-template" title="PO Multiselect - Template">
  *   <file name="sample-po-multiselect-template/sample-po-multiselect-template.component.html"> </file>
  *   <file name="sample-po-multiselect-template/sample-po-multiselect-template.component.ts"> </file>
+ *   <file name="sample-po-multiselect-template/sample-po-multiselect-template.component.css"> </file>
  * </example>
  *
  * <example name="po-multiselect-heroes" title="PO Multiselect - Heroes - using API">

package/lib/components/po-field/po-select/po-select.component.d.ts

@@ -22,6 +22,7 @@ import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
  * <example name="po-select-customer-registration" title="PO Select - Customer registration">
  *   <file name="sample-po-select-customer-registration/sample-po-select-customer-registration.component.html"> </file>
  *   <file name="sample-po-select-customer-registration/sample-po-select-customer-registration.component.ts"> </file>
+ *   <file name="sample-po-select-customer-registration/sample-po-select-customer-registration.component.css"> </file>
  *   <file name="sample-po-select-customer-registration/sample-po-select-customer-registration.service.ts"> </file>
  * </example>
  *

package/lib/components/po-field/po-textarea/po-textarea.component.d.ts

@@ -30,6 +30,7 @@ import { PoHelperComponent } from '../../po-helper';
 export declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit, OnChanges, OnDestroy {
     private readonly el;
     inputEl: ElementRef;
+    textareaBodyEl: ElementRef;
     helperEl?: PoHelperComponent;
     id: string;
     valueBeforeChange: any;
@@ -104,6 +105,6 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
     };
     private readonly onWindowResize;
     private checkScrollState;
-    private calculateTextareaHeight;
+    private syncContainerWidth;
     private initResizeObserver;
 }

package/lib/components/po-field/po-timepicker/enums/po-timepicker-iso-format.enum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @usedBy PoTimepickerComponent
+ *
+ * @description
+ *
+ * *Enum* que define o padrão de formatação do model de saída do timepicker.
+ */
+export declare enum PoTimepickerModelFormat {
+    /** Formato básico `HH:mm` (ex: `14:30`). */
+    HourMinute = "HH:mm",
+    /** Formato com segundos `HH:mm:ss` (ex: `14:30:00`). */
+    HourMinuteSecond = "HH:mm:ss"
+}

package/lib/components/po-field/po-timepicker/index.d.ts

@@ -0,0 +1,3 @@
+export * from './enums/po-timepicker-iso-format.enum';
+export * from './po-timepicker.component';
+export * from './po-timepicker.module';