@po-ui/ng-components 21.7.0 → 21.9.0

package/lib/components/po-context-menu/po-context-menu.component.d.ts

@@ -0,0 +1,51 @@
+import { WritableSignal } from '@angular/core';
+import { PoContextMenuBaseComponent } from './po-context-menu-base.component';
+import { PoContextMenuItem } from './po-context-menu-item.interface';
+interface PoContextMenuLiterals {
+    close: string;
+    open: string;
+}
+interface PoInternalContextMenuItem extends PoContextMenuItem {
+    tooltip?: string;
+}
+/**
+ * @docsExtends PoContextMenuBaseComponent
+ *
+ * @example
+ *
+ * <example name="po-context-menu-basic" title="PO Context Menu Basic">
+ *  <file name="sample-po-context-menu-basic/sample-po-context-menu-basic.component.html"> </file>
+ *  <file name="sample-po-context-menu-basic/sample-po-context-menu-basic.component.ts"> </file>
+ * </example>
+ *
+ * <example name="po-context-menu-labs" title="PO Context Menu Labs">
+ *  <file name="sample-po-context-menu-labs/sample-po-context-menu-labs.component.html"> </file>
+ *  <file name="sample-po-context-menu-labs/sample-po-context-menu-labs.component.ts"> </file>
+ * </example>
+ *
+ * <example name="po-context-menu-user" title="PO Context - Cadastro de Usuário">
+ *  <file name="sample-po-context-menu-user/sample-po-context-menu-user.component.html"> </file>
+ *  <file name="sample-po-context-menu-user/sample-po-context-menu-user.component.ts"> </file>
+ *  <file name="sample-po-context-menu-user/sample-po-context-menu-user.component.css"> </file>
+ * </example>
+ */
+export declare class PoContextMenuComponent extends PoContextMenuBaseComponent {
+    private readonly languageService;
+    literals: PoContextMenuLiterals;
+    protected _items: WritableSignal<PoInternalContextMenuItem[]>;
+    protected _titleTooltipCalculated: boolean;
+    protected _contextTitleTooltipCalculated: boolean;
+    protected titleTooltip: WritableSignal<string>;
+    protected contextTitleTooltip: WritableSignal<string>;
+    constructor();
+    toggleExpand(): void;
+    selectItem(item: PoContextMenuItem): void;
+    protected handlerItemTooltip(item: PoInternalContextMenuItem, value: HTMLLIElement): void;
+    protected handlerTitleTooltip(value: HTMLElement): void;
+    protected handlerContextTitleTooltip(value: HTMLElement): void;
+    private setLiterals;
+    private hasMultipleSelected;
+    private sanitizeSelection;
+    private applyTooltipIfOverflows;
+}
+export {};

package/lib/components/po-context-menu/po-context-menu.module.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description
+ *
+ * Módulo do componente po-context-menu.
+ */
+export declare class PoContextMenuModule {
+}

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

@@ -11,7 +11,7 @@ import { EventEmitter } from '@angular/core';
  *
  */
 export declare class PoDisclaimerBaseComponent {
-    private languageService;
+    private readonly languageService;
     /**
      * Label que aparecerá dentro do po-disclaimer.
      * Quando não for definido um label será apresentada a propriedade p-value.

package/lib/components/po-disclaimer-group/po-disclaimer-group-base.component.d.ts

@@ -64,7 +64,7 @@ export declare class PoDisclaimerGroupBaseComponent implements DoCheck {
     literals: any;
     private _disclaimers;
     private _hideRemoveAll;
-    private differ;
+    private readonly differ;
     private previousDisclaimers;
     /** Lista de *disclaimers*. */
     /**

package/lib/components/po-disclaimer-group/po-disclaimer-group.component.d.ts

@@ -25,7 +25,7 @@ import { PoDisclaimer } from '../po-disclaimer/po-disclaimer.interface';
  */
 export declare class PoDisclaimerGroupComponent extends PoDisclaimerGroupBaseComponent implements AfterViewInit, OnChanges {
     private subscription;
-    private el;
+    private readonly el;
     constructor();
     ngAfterViewInit(): void;
     ngOnChanges(changes: SimpleChanges): void;

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

@@ -26,8 +26,8 @@ import { PoDropdownBaseComponent } from './po-dropdown-base.component';
  * </example>
  */
 export declare class PoDropdownComponent extends PoDropdownBaseComponent {
-    private renderer;
-    private changeDetector;
+    private readonly renderer;
+    private readonly changeDetector;
     dropdownRef: ElementRef;
     popupRef: any;
     private clickoutListener;
@@ -37,7 +37,7 @@ export declare class PoDropdownComponent extends PoDropdownBaseComponent {
     private checkClickArea;
     private hideDropdown;
     private initializeListeners;
-    private onScroll;
+    private readonly onScroll;
     private isDropdownClosed;
     private removeListeners;
     private showDropdown;

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-dynamic/po-dynamic-form/po-dynamic-form-fields/po-dynamic-form-fields-base.component.d.ts

@@ -3,7 +3,7 @@ import { EventEmitter } from '@angular/core';
 import { PoDynamicSharedBase } from '../../shared/po-dynamic-shared-base';
 import { PoDynamicFormField } from '../interfaces/po-dynamic-form-field.interface';
 export declare class PoDynamicFormFieldsBaseComponent extends PoDynamicSharedBase {
-    private titleCasePipe;
+    private readonly titleCasePipe;
     autoFocus?: string;
     disabledForm: boolean;
     validate?: string | Function;

package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form-operation/po-dynamic-form-operation.d.ts

@@ -2,7 +2,7 @@ import { HttpClient } from '@angular/common/http';
 import { PoDynamicFormLoad } from '../po-dynamic-form-load/po-dynamic-form-load.interface';
 import { PoDynamicFormValidation } from '../po-dynamic-form-validation/po-dynamic-form-validation.interface';
 export declare class PoDynamicFormOperation {
-    private http;
+    private readonly http;
     constructor(http: HttpClient);
     protected execute(action: Function | string, param: any): import("rxjs").Observable<any>;
     protected post(url: string, body: PoDynamicFormValidation | any): import("rxjs").Observable<Object>;

package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form.component.d.ts

@@ -29,9 +29,9 @@ import { PoDynamicFormValidationService } from './po-dynamic-form-validation/po-
  *
  */
 export declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent implements OnInit, OnDestroy {
-    private changes;
-    private loadService;
-    private validationService;
+    private readonly changes;
+    private readonly loadService;
+    private readonly validationService;
     fieldsComponent: {
         focus: (property: string) => void;
         updatePreviousValue: () => void;
@@ -42,7 +42,7 @@ export declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent i
     private _form;
     private onLoadSubscription;
     private sendFormSubscription;
-    private comboOptionSubject;
+    private readonly comboOptionSubject;
     set form(value: NgForm);
     get form(): NgForm;
     constructor(changes: ChangeDetectorRef, loadService: PoDynamicFormLoadService, validationService: PoDynamicFormValidationService);

package/lib/components/po-dynamic/po-dynamic-view/po-dynamic-view-base.component.d.ts

@@ -15,11 +15,11 @@ import { PoDynamicSharedBase } from '../shared/po-dynamic-shared-base';
  *
  */
 export declare class PoDynamicViewBaseComponent extends PoDynamicSharedBase {
-    private currencyPipe;
-    private datePipe;
-    private decimalPipe;
-    private timePipe;
-    private titleCasePipe;
+    private readonly currencyPipe;
+    private readonly datePipe;
+    private readonly decimalPipe;
+    private readonly timePipe;
+    private readonly titleCasePipe;
     protected dynamicViewService: PoDynamicViewService;
     protected comboFilterService: PoComboFilterService;
     protected multiselectFilterService: PoMultiselectFilterService;

package/lib/components/po-dynamic/po-dynamic-view/services/po-dynamic-view.service.d.ts

@@ -9,7 +9,7 @@ import { PoDynamicViewField } from '../po-dynamic-view-field.interface';
  * Serviço padrão utilizado para filtrar os dados dos campos que utilizam a propriedade `searchService`.
  */
 export declare class PoDynamicViewService {
-    private httpClient;
+    private readonly httpClient;
     readonly headers: HttpHeaders;
     url: string;
     getObjectByValue(value: any, filterParams?: any): Observable<Array<any> | {

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-checkbox/po-checkbox-base.component.d.ts

@@ -76,8 +76,6 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
      */
     appendBox?: boolean;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -212,8 +210,6 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     set size(value: string);
     get size(): string;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -225,8 +221,6 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description

package/lib/components/po-field/po-checkbox-group/po-checkbox-group-base.component.d.ts

@@ -75,8 +75,6 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      */
     autoFocus: boolean;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -158,8 +156,6 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      */
     errorLimit: boolean;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -171,8 +167,6 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description

package/lib/components/po-field/po-checkbox-group/po-checkbox-group.component.d.ts

@@ -24,10 +24,10 @@ import { PoHelperComponent } from '../../po-helper';
  * </example>
  */
 export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent implements AfterViewChecked, AfterViewInit, OnChanges {
-    private changeDetector;
+    private readonly changeDetector;
     checkboxLabels: QueryList<PoCheckboxComponent>;
     helperEl?: PoHelperComponent;
-    private el;
+    private readonly el;
     ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewChecked(): void;
     ngAfterViewInit(): void;

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

@@ -103,8 +103,6 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      */
     autoFocus: boolean;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -369,8 +367,6 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      */
     listboxControlPosition: 'top' | 'bottom';
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -382,8 +378,6 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -435,7 +429,7 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
     private _size?;
     private _initialSize?;
     private _sort?;
-    private language;
+    private readonly language;
     private _infiniteScrollDistance?;
     private _infiniteScroll?;
     private _removeInitialFilter;

package/lib/components/po-field/po-combo/po-combo-filter.service.d.ts

@@ -10,7 +10,7 @@ import { PoComboOption } from './interfaces/po-combo-option.interface';
  * Serviço padrão utilizado para filtrar os dados do componente po-combo.
  */
 export declare class PoComboFilterService implements PoComboFilter {
-    private http;
+    private readonly http;
     fieldLabel: string;
     fieldValue: string;
     hasNext: boolean;

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

@@ -58,7 +58,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     differs: IterableDiffers;
     defaultService: PoComboFilterService;
     renderer: Renderer2;
-    private controlPosition;
+    private readonly controlPosition;
     comboOptionTemplate: PoComboOptionTemplateDirective;
     outerContainer: ElementRef;
     containerElement: ElementRef;
@@ -82,7 +82,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     private eventResizeListener;
     private filterSubscription;
     private getSubscription;
-    private subscriptionScrollEvent;
+    private readonly subscriptionScrollEvent;
     constructor();
     set isServerSearching(value: boolean);
     get isServerSearching(): boolean;
@@ -170,7 +170,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     private initializeListeners;
     private isAdditionalHelpEventTriggered;
     private onErrorGetObjectByValue;
-    private onScroll;
+    private readonly onScroll;
     private onErrorFilteredData;
     private open;
     private removeListeners;

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

@@ -110,8 +110,6 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      */
     autoFocus: boolean;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -244,8 +242,6 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      */
     keydown: EventEmitter<KeyboardEvent>;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -257,8 +253,6 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description

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

@@ -29,8 +29,8 @@ import { PoHelperComponent } from '../../po-helper';
  * </example>
  */
 export declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements AfterViewInit, OnDestroy, OnChanges {
-    private controlPosition;
-    private renderer;
+    private readonly controlPosition;
+    private readonly renderer;
     calendar: PoCalendarComponent;
     dialogPicker: ElementRef;
     iconDatepicker: PoButtonComponent;
@@ -135,7 +135,7 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     private isAdditionalHelpEventTriggered;
     private isFocusOnFirstCombo;
     private isFocusOnLastCombo;
-    private onScroll;
+    private readonly onScroll;
     private removeListeners;
     private setDialogPickerStyleDisplay;
     private setCalendarPosition;

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
  *
@@ -50,7 +51,7 @@ import { PoHelperOptions } from '../../po-helper';
 export declare abstract class PoDatepickerRangeBaseComponent implements ControlValueAccessor, Validator, OnDestroy {
     protected changeDetector: ChangeDetectorRef;
     protected poDateService: PoDateService;
-    private languageService;
+    private readonly languageService;
     additionalHelpEventTrigger: string | undefined;
     name: string;
     /**
@@ -94,8 +95,6 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      */
     autoFocus: boolean;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -132,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
      *
@@ -208,8 +260,6 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      */
     errorLimit: boolean;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -221,8 +271,6 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -274,7 +322,7 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     private _size?;
     private _initialSize?;
     private _placeholder;
-    private language;
+    private readonly language;
     private onChangeModel;
     private validatorChange;
     private subscription;