@po-ui/ng-components 21.12.0 → 21.13.1

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

@@ -21,7 +21,9 @@ import { PoButtonBaseComponent } from './po-button-base.component';
  * </example>
  */
 export declare class PoButtonComponent extends PoButtonBaseComponent {
+    elementRef: ElementRef;
     buttonElement: ElementRef;
+    constructor(elementRef: ElementRef);
     onBlur(): void;
     /**
      * Função que atribui foco ao componente.

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

@@ -207,6 +207,9 @@ export declare class PoCalendarBaseComponent {
     set mode(value: PoCalendarMode);
     get mode(): PoCalendarMode;
     get isRange(): boolean;
+    get isMonthYear(): boolean;
+    get isYear(): boolean;
+    yearRangeLimit?: number;
     headerTemplate?: TemplateRef<any>;
     /**
      * @optional

package/lib/components/po-calendar/po-calendar-mode.enum.d.ts

@@ -7,5 +7,7 @@
  */
 export declare enum PoCalendarMode {
     /** Modo de seleção de intervalo (data inicial e final). */
-    Range = "range"
+    Range = "range",
+    MonthYear = "month-year",
+    Year = "year"
 }

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

@@ -1,5 +1,6 @@
-import { DoCheck, OnChanges, OnInit, SimpleChanges } from '@angular/core';
+import { DoCheck, OnChanges, OnInit, SimpleChanges, QueryList } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
+import { PoButtonComponent } from '../po-button';
 import { PoCalendarBaseComponent } from './po-calendar-base.component';
 import { PoCalendarRangePreset } from './interfaces/po-calendar-range-preset.interface';
 /**
@@ -28,10 +29,19 @@ import { PoCalendarRangePreset } from './interfaces/po-calendar-range-preset.int
  * </example>
  */
 export declare class PoCalendarComponent extends PoCalendarBaseComponent implements OnInit, OnChanges, DoCheck {
+    monthOptions: QueryList<PoButtonComponent>;
+    yearOptions: QueryList<PoButtonComponent>;
     private readonly changeDetector;
     private readonly poCalendarLangService;
     hoverValue: Date;
     displayToClean: string;
+    displayMonths: Array<string>;
+    displayYears: Array<number>;
+    focusedIndex: number;
+    selectedIndexMonth: number | null;
+    selectedIndexYear: number | null;
+    selectedMonth: number | null;
+    selectedYear: number | null;
     private readonly _isRange;
     private readonly _rangePresetsValue;
     private readonly _rangePresetOptionsValue;
@@ -44,6 +54,15 @@ export declare class PoCalendarComponent extends PoCalendarBaseComponent impleme
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngDoCheck(): void;
+    isMonthDisabled(monthIndex: number): boolean;
+    isYearDisabled(year: number): boolean;
+    onKeydownMonth(event: KeyboardEvent, index: number): void;
+    onKeydownYear(event: KeyboardEvent, index: number): void;
+    selectMonth(index: number, event?: KeyboardEvent, selected?: boolean): void;
+    selectYear(index: number, event?: KeyboardEvent, selected?: boolean, year?: any): void;
+    private getMonthOptions;
+    private getYearOptions;
+    private initializeYearAndMonthMode;
     getActivateDate(partType: any): any;
     getValue(partType: any): any;
     onSelectDate(selectedDate: any, partType?: any): void;
@@ -75,5 +94,7 @@ export declare class PoCalendarComponent extends PoCalendarBaseComponent impleme
     private convertDateToISO;
     private convertDateFromIso;
     private updateModel;
+    private setMonth;
+    private setYear;
     private writeDate;
 }

package/lib/components/po-dropdown/po-dropdown-action.interface.d.ts

@@ -1,7 +1,8 @@
 import { PoPopupAction } from '../po-popup/po-popup-action.interface';
 /**
  * @description
- * Interface do componente po-dropdown
+ *
+ * Interface para as ações do componente `po-dropdown`.
  *
  * @docsExtends PoPopupAction
  *
@@ -9,13 +10,13 @@ import { PoPopupAction } from '../po-popup/po-popup-action.interface';
  */
 export interface PoDropdownAction extends PoPopupAction {
     /**
-     * Array de ações (`PoDropdownAction`) usado para criar agrupadores de subitens.
+     * @optional
+     *
+     * @description
      *
-     * - Permite a criação de menus aninhados (submenus).
+     * Array de ações (`PoDropdownAction`) usado para criar agrupadores de subitens (submenus).
      *
-     * > Boas práticas de desenvolvimento:
-     * Recomenda-se limitar a navegação a, no máximo, três níveis hierárquicos.
-     * Isso evita sobrecarga cognitiva, facilita a memorização da estrutura e garante uma melhor experiência de uso.
+     * > Recomenda-se limitar a navegação a, no máximo, três níveis hierárquicos.
      */
     subItems?: Array<PoDropdownAction>;
 }

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

@@ -67,6 +67,7 @@ export declare class PoDropdownBaseComponent {
     private _disabled;
     private _size?;
     private _initialSize?;
+    private _position;
     /** Lista de ações que serão exibidas no componente. */
     set actions(value: Array<PoDropdownAction>);
     get actions(): Array<PoDropdownAction>;
@@ -97,6 +98,34 @@ export declare class PoDropdownBaseComponent {
      */
     set size(value: string);
     get size(): string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define a posição preferencial de abertura do popup do dropdown em relação ao botão.
+     *
+     * Posições válidas:
+     * - `right`: No lado direito.
+     * - `right-bottom`: No lado direito inferior.
+     * - `right-top`: No lado direito superior.
+     * - `bottom`: Abaixo.
+     * - `bottom-left`: Abaixo e à esquerda (padrão).
+     * - `bottom-right`: Abaixo e à direita.
+     * - `left`: No lado esquerdo.
+     * - `left-top`: No lado esquerdo superior.
+     * - `left-bottom`: No lado esquerdo inferior.
+     * - `top`: Acima.
+     * - `top-right`: Acima e à direita.
+     * - `top-left`: Acima e à esquerda.
+     *
+     * > O popup será rotacionado automaticamente caso não caiba na posição definida.
+     *
+     * @default `bottom-left`
+     */
+    set position(value: string);
+    get position(): string;
+    get popupCustomPositions(): Array<string>;
     protected onThemeChange(): void;
     private applySizeBasedOnA11y;
 }

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

@@ -9,6 +9,7 @@ import { ForceBooleanComponentEnum, ForceOptionComponentEnum } from '../../enums
 import { Observable } from 'rxjs';
 import { PoDynamicField } from '../../po-dynamic-field.interface';
 import { PoHelperOptions } from '../../../po-helper';
+import { PoCalendarRangePreset } from '../../../po-calendar/interfaces/po-calendar-range-preset.interface';
 /**
  * @usedBy PoDynamicFormComponent, PoAdvancedFilterComponent, PoPageDynamicSearchComponent
  *
@@ -55,7 +56,13 @@ export interface PoDynamicFormField extends PoDynamicField {
      * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
      */
     keydown?: Function;
-    /** Define a obrigatoriedade do campo. */
+    /**
+     * Define a obrigatoriedade do campo.
+     *
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-timepicker`, `po-input`, `po-number`,
+     * `po-decimal`, `po-select`, `po-radio-group`, `po-combo`, `po-lookup`, `po-checkbox-group`, `po-multiselect`,
+     * `po-textarea`, `po-password``, `po-upload`.
+     */
     required?: boolean;
     /**
      *
@@ -63,7 +70,7 @@ export interface PoDynamicFormField extends PoDynamicField {
      *
      * > Necessário que a propriedade `required` esteja habilitada.
      *
-     * **Componentes compatíveis:** `po-datepicker`, `po-input`, `po-number`, `po-decimal`, `po-password`.
+     * **Componentes compatíveis:** `po-datepicker`, `po-timepicker`, `po-input`, `po-number`, `po-decimal`, `po-password`.
      */
     requiredFieldErrorMessage?: boolean;
     /**
@@ -72,6 +79,10 @@ export interface PoDynamicFormField extends PoDynamicField {
      * > A indicação não será exibida, se:
      * - O campo for `required`, ou;
      * - Não possuir `help` e `label`.
+     *
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-timepicker`, `po-input`, `po-number`,
+     * `po-decimal`, `po-select`, `po-radio-group`, `po-combo`, `po-lookup`, `po-checkbox-group`, `po-multiselect`,
+     * `po-textarea`, `po-password`.
      */
     optional?: boolean;
     /**
@@ -300,14 +311,15 @@ export interface PoDynamicFormField extends PoDynamicField {
      *  - required;
      *
      * > Esta mensagem pode ser exibida quando o campo estiver vazio, caso seja requerido. Em casos de componentes como
-     * `po-datepicker`, `po-input`, `po-number`, `po-decimal`, `po-password`, é necessário que a propriedade
+     * `po-datepicker`, `po-input`, `po-number`, `po-decimal`, `po-password`, `po-timepicker`, é necessário que a propriedade
      * `requiredFieldErrorMessage` esteja como `true` para que a mensagem seja exibida com o campo vazio. Componentes
      * como `po-datepicker-range`, `po-select`, `po-checkbox-group`, `po-radio-group`, `po-multiselect`, `po-combo`,
      * `po-lookup` e `po-textarea` não é necessário passar a propriedade `requiredFieldErrorMessage`.
      *
      *
      * **Componentes compatíveis:**  `po-checkbox-group`, `po-combo`, `po-datepicker`, `po-datepicker-range`,
-     *  `po-decimal`, `po-input`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`, `po-radio-group`, `po-select`, `po-switch`, `po-textarea`.
+     *  `po-decimal`, `po-input`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`, `po-radio-group`, `po-select`,
+     * `po-switch`, `po-textarea`, `po-timepicker`.
      */
     errorMessage?: string;
     /**
@@ -321,7 +333,8 @@ export interface PoDynamicFormField extends PoDynamicField {
      * e um tooltip será exibido ao passar o mouse sobre a mensagem para mostrar o conteúdo completo.
      *
      * **Componentes compatíveis:** `po-checkbox-group`, `po-combo`, `po-datepicker`, `po-datepicker-range`,
-     *  `po-decimal`, `po-input`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`, `po-radio-group`, `po-select`, `po-switch`, `po-textarea`.
+     *  `po-decimal`, `po-input`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`, `po-radio-group`, `po-select`,
+     * `po-switch`, `po-textarea`, `po-timepicker`.
      *
      * @default `false`
      */
@@ -362,6 +375,8 @@ export interface PoDynamicFormField extends PoDynamicField {
      *
      * 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"].
+     *
+     * **Componentes compatíveis:** `po-datepicker`, `po-timepicker`, `po-lookup`.
      */
     format?: string | Array<string>;
     /**
@@ -411,7 +426,12 @@ export interface PoDynamicFormField extends PoDynamicField {
      * array.
      */
     order?: number;
-    /** Mensagem que será exibida enquanto o campo não estiver preenchido. */
+    /**
+     * Mensagem que será exibida enquanto o campo não estiver preenchido.
+     *
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-timepicker`, `po-input`, `po-number`,
+     *  `po-decimal`, `po-select`, `po-combo`, `po-lookup`, `po-multiselect`, `po-textarea`, `po-password`.
+     */
     placeholder?: string;
     /**
      * Define a localidade a ser utilizada no componente.
@@ -426,7 +446,8 @@ export interface PoDynamicFormField extends PoDynamicField {
      * ```
      *
      * > Para ver quais linguagens suportadas acesse [`I18n`](documentation/po-i18n)
-     * > A propriedade será repassada para os componentes que suportam a mesma.
+     *
+     * **Componentes compatíveis:** `po-datepicker`, `po-decimal`, `po-timepicker`.
      */
     locale?: string;
     /**
@@ -437,7 +458,8 @@ export interface PoDynamicFormField extends PoDynamicField {
     range?: boolean;
     /** Indica que o campo será somente leitura.
      *
-     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-input`, `po-number`, `po-decimal`, `po-select`, `po-textarea`, `po-password`
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-timepicker`, `po-input`, `po-number`,
+     * `po-decimal`, `po-select`, `po-textarea`, `po-password`.
      */
     readonly?: boolean;
     /**
@@ -448,13 +470,15 @@ export interface PoDynamicFormField extends PoDynamicField {
     multiple?: boolean;
     /** Se verdadeiro, o campo receberá um botão para ser limpo.
      *
-     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-input`, `po-number`, `po-decimal`, `po-combo`, `po-lookup`, `po-password`
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-input`, `po-number`, `po-decimal`,
+     * `po-combo`, `po-lookup`, `po-password`, `po-timepicker`.
      */
     clean?: boolean;
     /**
      * Define a propriedade nativa `autocomplete` do campo como off.
      *
-     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-input`, `po-number`, `po-decimal`, `po-lookup`, `po-password`
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-input`, `po-number`, `po-decimal`,
+     * `po-lookup`, `po-password`, `po-timepicker`.
      */
     noAutocomplete?: boolean;
     /**
@@ -727,6 +751,10 @@ export interface PoDynamicFormField extends PoDynamicField {
      *
      * > Não será exibida a indicação se:
      * - Não possuir `p-help` e/ou `p-label`.
+     *
+     * **Componentes compatíveis:** `po-datepicker`, `po-datepicker-range`, `po-timepicker`, `po-input`, `po-number`,
+     * `po-decimal`, `po-select`, `po-radio-group`, `po-combo`, `po-lookup`, `po-checkbox-group`, `po-multiselect`,
+     * `po-textarea`, `po-password`, `po-upload`.
      */
     showRequired?: boolean;
     /**
@@ -868,4 +896,55 @@ export interface PoDynamicFormField extends PoDynamicField {
      * **Compatível com todos os componentes**
      */
     compactLabel?: boolean;
+    /**
+     * Define o modo de seleção do `po-datepicker`.
+     *
+     * Valores aceitos:
+     * - `'month-year'`: exibe seleção de mês e ano (formato `MM/YYYY`)
+     * - `'year'`: exibe seleção apenas de ano (formato `YYYY`)
+     *
+     * **Componente compatível:** `po-datepicker`
+     */
+    mode?: 'month-year' | 'year';
+    /**
+     * Define o limite de anos exibidos na lista de anos do `po-datepicker` nos modos `month-year` e `year`.
+     *
+     * @default `150`
+     *
+     * **Componente compatível:** `po-datepicker`
+     */
+    yearRangeLimit?: number;
+    /**
+     * 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.
+     * - `false`: não exibe os presets padrão.
+     * - `Array<string>`: exibe apenas os presets padrão cujos labels estejam no array informado.
+     *
+     * **Componente compatível:** `po-datepicker-range`
+     *
+     * @default `false`
+     */
+    rangePresets?: boolean | Array<string>;
+    /**
+     * Lista de presets customizados de intervalos de data exibidos no painel lateral do calendário.
+     *
+     * Para utilizar presets customizados, informe um array de objetos que implementam a interface `PoCalendarRangePreset`.
+     *
+     * **Componente compatível:** `po-datepicker-range`
+     */
+    rangePresetOptions?: Array<PoCalendarRangePreset>;
+    /**
+     * Define a ordenação dos presets na lista.
+     *
+     * Valores aceitos:
+     * - `'asc'`: ordenação crescente (passado → futuro)
+     * - `'desc'`: ordenação decrescente (futuro → passado)
+     *
+     * **Componente compatível:** `po-datepicker-range`
+     *
+     * @default `'asc'`
+     */
+    rangePresetsOrder?: 'asc' | 'desc';
 }

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

@@ -82,6 +82,28 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
     protected languageService: PoLanguageService;
     protected cd: ChangeDetectorRef;
     additionalHelpEventTrigger: string | undefined;
+    /** Rótulo do campo. */
+    label?: string;
+    /** Texto de apoio do campo. */
+    help?: string;
+    /**
+     * Define o modo de operação do datepicker.
+     *
+     * Permite configurar o componente para seleção de:
+     * - Mês e ano (`month-year`);
+     * - Apenas ano (`year`).
+     */
+    mode?: 'month-year' | 'year';
+    /**
+     * Define o limite de anos exibidos nas variações `month-year` e `year`,
+     * considerando a data atual como referência.
+     *
+     * O valor informado determina o intervalo de anos anterior e posterior
+     * à data corrente que será disponibilizado para seleção.
+     *
+     * @default 150
+     */
+    yearRangeLimit?: number;
     /**
      *
      * @deprecated v23.x.x use `p-helper`
@@ -380,6 +402,8 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      *  - `mm/dd/yyyy`
      *  - `yyyy/mm/dd`
      *
+     * Propriedade incompatível com as variações month-year e year.
+     *
      * @default `dd/mm/yyyy`
      */
     set format(value: string);
@@ -392,6 +416,8 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * Padrão de formatação para saída do *model*, independentemente do formato de entrada.
      *
      * > Veja os valores válidos no *enum* `PoDatepickerIsoFormat`.
+     *
+     * Propriedade incompatível com as variações month-year e year.
      */
     set isoFormat(value: PoDatepickerIsoFormat);
     get isoFormat(): PoDatepickerIsoFormat;
@@ -450,6 +476,10 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
     validate(c: AbstractControl): {
         [key: string]: any;
     };
+    private isMonthYearOrYearInvalid;
+    private isDateRangeValidForMode;
+    private validateMonthYearRange;
+    private validateYearRange;
     protected validateModel(model: any): void;
     protected buildMask(format?: string): PoMask;
     formatTimezoneAndHour(offset: number): void;

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

@@ -18,6 +18,16 @@ import { PoHelperComponent } from '../../po-helper';
  *  <file name="sample-po-datepicker-labs/sample-po-datepicker-labs.component.ts"> </file>
  * </example>
  *
+ * <example name="po-datepicker-year" title="PO Datepicker Year">
+ *  <file name="sample-po-datepicker-year/sample-po-datepicker-year.component.html"> </file>
+ *  <file name="sample-po-datepicker-year/sample-po-datepicker-year.component.ts"> </file>
+ * </example>
+ *
+ * <example name="po-datepicker-month-year" title="PO Datepicker MonthYear">
+ *  <file name="sample-po-datepicker-month-year/sample-po-datepicker-month-year.component.html"> </file>
+ *  <file name="sample-po-datepicker-month-year/sample-po-datepicker-month-year.component.ts"> </file>
+ * </example>
+ *
  * <example name="po-datepicker-airfare" title="PO Datepicker - Airfare">
  *  <file name="sample-po-datepicker-airfare/sample-po-datepicker-airfare.component.html"> </file>
  *  <file name="sample-po-datepicker-airfare/sample-po-datepicker-airfare.component.ts"> </file>
@@ -37,10 +47,6 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     inputEl: ElementRef;
     iconClean: ElementRef<HTMLElement>;
     helperEl?: PoHelperComponent;
-    /** Rótulo do campo. */
-    label?: string;
-    /** Texto de apoio do campo. */
-    help?: string;
     displayAdditionalHelp: boolean;
     el: ElementRef;
     hour: string;
@@ -85,7 +91,7 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     getAdditionalHelpTooltip(): string;
     togglePicker(focusInput?: boolean): void;
     closeCalendar(focusInput?: boolean): void;
-    dateSelected(event?: string): void;
+    dateSelected(event?: any): void;
     wasClickedOnPicker(event: any): void;
     hasInvalidClass(): boolean;
     getErrorPattern(): string;
@@ -95,7 +101,7 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     eventOnClick($event: any): void;
     onKeyDown(event: KeyboardEvent): void;
     onKeyPress(event: any): void;
-    formatToDate(value: Date): string;
+    formatToDate(value: any): string;
     refreshValue(value: Date): void;
     /**
      * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
@@ -123,13 +129,32 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
      * ```
      */
     showAdditionalHelp(): boolean;
+    private handleSpecialModes;
+    private processValue;
+    private handleDateInstance;
+    private handleIsoString;
+    private clearValue;
+    private resetInput;
+    private finalizeWrite;
     writeValue(value: any): void;
     isValidDateIso(value: string): boolean;
     isValidExtendedIso(value: any): boolean;
     hasOverlayClass(element: any): any;
     verifyErrorAsync(value: any): void;
     verifyMobile(): RegExpMatchArray;
+    private handleMonthYearKeyup;
+    private handleYearKeyup;
+    private handleMonthYearBlur;
+    private handleYearBlur;
+    private applyMonthYearValue;
+    private applyYearValue;
+    private parseMonthYearInput;
+    private syncCalendarMonthYear;
+    private syncCalendarYear;
+    private writeMonthYearValue;
+    private writeYearValue;
     private controlChangeEmitter;
+    private isValidInputForMode;
     private hasAttrCalendar;
     private initializeListeners;
     private isAdditionalHelpEventTriggered;

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

@@ -1,5 +1,5 @@
 /**
- * @usedBy PoTimepickerComponent
+ * @usedBy PoTimepickerComponent, PoDynamicFormComponent
  *
  * @description
  *

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

@@ -71,6 +71,7 @@ export declare class PoTimepickerComponent extends PoTimepickerBaseComponent imp
     get hourPlaceholder(): string;
     get minutePlaceholder(): string;
     get secondPlaceholder(): string;
+    get isPlaceholder(): boolean;
     private get customPlaceholderSegments();
     private getCustomPlaceholderSegment;
     onHostFocusOut(event: FocusEvent): void;
@@ -130,6 +131,7 @@ export declare class PoTimepickerComponent extends PoTimepickerBaseComponent imp
     writeValue(value: any): void;
     verifyMobile(): RegExpMatchArray;
     handleCleanKeyboardTab(event: KeyboardEvent): void;
+    handleTimepickerButtonKeyboardTab(event: KeyboardEvent): void;
     onTimerKeyDown(event: KeyboardEvent): void;
     onTimerBoundaryTab(payload: {
         direction: 'forward' | 'backward';
@@ -156,9 +158,22 @@ export declare class PoTimepickerComponent extends PoTimepickerBaseComponent imp
     private getDefaultPeriodDisplay;
     /** Sincroniza os valores dos elementos input nativos com as propriedades de exibicao. */
     private syncSegmentInputElements;
-    /** Avanca o foco para o proximo input de segmento. */
+    /**
+     * Avança o foco para o próximo input de segmento ou elemento focável interno.
+     * Retorna `true` se o foco foi movido, `false` se não há próximo elemento focável.
+     */
     private advanceToNextSegment;
-    /** Avanca o foco para o input de segmento anterior. */
+    /**
+     * Tenta focar o botão de limpar ou o botão do timer.
+     * Retorna `true` se o foco foi movido, `false` se nenhum elemento está focável.
+     */
+    private focusCleanOrButton;
+    private focusPreviousPeriodSegment;
+    private focusNextPeriodSegment;
+    /**
+     * Retorna o foco para o input de segmento anterior.
+     * Retorna `true` se o foco foi movido, `false` se não há segmento anterior focável.
+     */
     private advanceToPreviousSegment;
     /** Foca o ultimo input de segmento visivel. */
     private focusLastSegment;
@@ -166,6 +181,11 @@ export declare class PoTimepickerComponent extends PoTimepickerBaseComponent imp
     private isLastSegment;
     /** Alterna entre AM e PM no display de periodo e atualiza o modelo. */
     private togglePeriod;
+    /**
+     * Verifica se um período (AM/PM) está completamente fora do range min/max.
+     * AM corresponde às horas 0-11 em 24h, PM às horas 12-23.
+     */
+    private isPeriodBlocked;
     /** Incrementa ou decrementa o valor de um segmento na direcao indicada (+1 ou -1), respeitando limites e intervalos. */
     private incrementSegment;
     private incrementHourSegment;

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

@@ -1,3 +1,5 @@
+export * from './po-page-default/enums/po-page-actions-layout.enum';
+export * from './po-page-default/enums/po-page-header-type.enum';
 export * from './po-page-default/po-page-default.component';
 export * from './po-page-default/po-page-default.interface';
 export * from './po-page-default/po-page-default-literals.interface';

package/lib/components/po-page/interfaces/po-page-action.interface.d.ts

@@ -1,11 +1,14 @@
 import { PoDropdownAction } from '../../po-dropdown';
 /**
  * @description
- * Interface para as ações dos componentes po-page-default e po-page-list.
  *
- * > Quando o array de actions possui quatro ou mais registros, os dois últimos e os seguintes são automaticamente agrupados no po-dropdown.
- * A partir desse ponto, as propriedades `selected`, `separator`, `type` e `subItems` passam a ter efeito apenas nas ações exibidas dentro do dropdown, ou seja, a partir da terceira ação.
- * Dessa forma, o uso de subItems (agrupadores dentro do dropdown) só terá efeito quando houver pelo menos quatro ações definidas.
+ * Interface para as ações dos componentes `po-page-default` e `po-page-list`.
+ *
+ * As ações podem ser exibidas como botões no cabeçalho ou agrupadas em um *dropdown*,
+ * conforme o `PoPageActionsLayout` e o tamanho da tela.
+ *
+ * > As propriedades `separator`, `selected` e `subItems` possuem efeito apenas quando
+ * a ação é exibida dentro do *dropdown*.
  *
  * @docsExtends PoDropdownAction
  *
@@ -14,4 +17,23 @@ import { PoDropdownAction } from '../../po-dropdown';
  * @usedBy PoPageDefaultComponent, PoPageListComponent
  */
 export interface PoPageAction extends PoDropdownAction {
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o estilo visual da ação quando exibida como botão fora do *dropdown*.
+     *
+     * Valores permitidos:
+     * - `primary`: botão com maior destaque visual.
+     * - `secondary`: estilo padrão.
+     *
+     * > Valores inválidos são ignorados e o componente aplica o estilo padrão da posição.
+     *
+     * > Somente uma ação pode ter `kind` igual a `primary`. Caso mais de uma defina `primary`,
+     * apenas a primeira será mantida e as demais receberão `secondary`.
+     *
+     * > Quando não definido, o estilo é determinado pelo `PoPageActionsLayout`.
+     */
+    kind?: string;
 }

package/lib/components/po-page/po-page-content/po-page-content.component.d.ts

@@ -1,4 +1,4 @@
-import { AfterViewInit, OnDestroy, Renderer2 } from '@angular/core';
+import { AfterViewInit, OnDestroy } from '@angular/core';
 import { PoPageContentBaseComponent } from './po-page-content-base.component';
 /**
  * @docsPrivate
@@ -6,15 +6,21 @@ import { PoPageContentBaseComponent } from './po-page-content-base.component';
  * @docsExtends PoPageContentBaseComponent
  */
 export declare class PoPageContentComponent extends PoPageContentBaseComponent implements AfterViewInit, OnDestroy {
-    renderer: Renderer2;
+    private readonly renderer;
+    private readonly elementRef;
+    private readonly ngZone;
     contentOpacity: number;
     height: string;
-    overflowY: string;
     constructor();
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
+    /**
+     * Recalcula a altura do po-page-content.
+     * Chamado internamente pelo po-page-default quando inputs que afetam
+     * o tamanho do header mudam (title, subtitle, breadcrumb, headerType, theme).
+     */
     recalculateHeaderSize(): void;
-    setHeightContent(poPageHeader: HTMLElement): void;
+    private setHeightContent;
     private initializeListeners;
     private removeListeners;
 }

package/lib/components/po-page/po-page-default/enums/po-page-actions-layout.enum.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @usedBy PoPageDefaultComponent
+ *
+ * @description
+ *
+ * Define os layouts de exibição das ações no cabeçalho do `po-page-default`.
+ *
+ * > Compatível com todos os valores de `PoPageHeaderType`.
+ */
+export declare enum PoPageActionsLayout {
+    /**
+     * Exibe as ações como botões (até 3 em desktop e 2 em mobile), agrupando as demais no *dropdown*.
+     *
+     * Quando `PoPageAction.kind` não é definido, a primeira ação recebe o estilo `primary`
+     * e as demais recebem `secondary`.
+     */
+    default = "default",
+    /**
+     * Agrupa todas as ações exclusivamente dentro do menu *dropdown*.
+     */
+    dropdown = "dropdown",
+    /**
+     * Exibe a primeira ação como botão e agrupa as demais no *dropdown*.
+     */
+    mixed = "mixed"
+}