@po-ui/ng-components 21.28.0 → 21.30.0

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

@@ -117,6 +117,8 @@ export interface PoDynamicFormField extends PoDynamicField {
      *
      * **Componente compatível:** `po-input`.
      * > também é atribuído ao utilizar a propriedade `type: time`.
+     *
+     * > Incompatível com `po-decimal`.
      */
     mask?: string;
     /**
@@ -167,17 +169,23 @@ export interface PoDynamicFormField extends PoDynamicField {
     /**  Quantidade máxima de casas decimais.
      *
      * > Esta propriedade só pode ser utilizada quando o `type` for *currency* ou *decimal*.
+     *
+     * > Quando utilizado com `displayFormat`, será respeitado o valor **mais restritivo** entre esta propriedade e o número de casas decimais definido no formato.
      */
     decimalsLength?: number;
     /** Quantidade máxima de dígitos antes do separador decimal. O valor máximo permitido é 13
      *
      * > Esta propriedade só pode ser utilizada quando o `type` for *currency* ou *decimal*.
+     *
+     * > Quando utilizado com `displayFormat`, será respeitado o valor **mais restritivo** entre esta propriedade e o número de dígitos inteiros definido no formato.
      */
     thousandMaxlength?: number;
     /**
      * Regex para validação do campo.
      *
      * **Componentes compatíveis:** `po-input`, `po-password`.
+     *
+     * > Incompatível com `po-decimal`.
      * */
     pattern?: string;
     /**
@@ -379,6 +387,26 @@ export interface PoDynamicFormField extends PoDynamicField {
      * **Componentes compatíveis:** `po-datepicker`, `po-datetimepicker`, `po-timepicker`, `po-lookup`.
      */
     format?: string | Array<string>;
+    /**
+     * Define uma máscara de formatação numérica avançada para o campo.
+     *
+     * Simbologia suportada:
+     * - `9`: Dígito obrigatório (preenche com zero à esquerda no blur);
+     * - `>`: Supressão de zero à esquerda (dígito não obrigatório);
+     * - `<`: Decimal flutuante, supressão de zeros à direita (dígito não obrigatório);
+     * - `.`: Separador decimal (convertido conforme locale);
+     * - `,`: Separador de milhar/grupo (convertido conforme locale);
+     * - `-`: Sinal negativo (deve ser o primeiro caractere do formato).
+     *
+     * > Quando utilizado com `decimalsLength` ou `thousandMaxlength`, será respeitado o valor **mais restritivo** entre a propriedade e o formato.
+     *
+     * Exemplos: `'>>>,>>>,>>9.99'`, `'->>9.99'`, `'999.9'`
+     *
+     * > Esta propriedade só pode ser utilizada quando o `type` for *currency* ou *decimal*.
+     *
+     * **Componente compatível:** `po-decimal`.
+     */
+    displayFormat?: string;
     /**
      * Nome da propriedade do objeto retornado que será utilizado como descrição do campo.
      *

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

@@ -21,6 +21,9 @@ export * from './po-datepicker-range/po-datepicker-range.component';
 export * from './po-datetimepicker/po-datetimepicker.component';
 export * from './po-datetimepicker/po-datetimepicker.module';
 export * from './po-decimal/po-decimal.component';
+export * from './po-decimal/utils/po-decimal-format.util';
+export * from './po-decimal/interfaces/po-decimal-format-parsed.interface';
+export * from './po-decimal/interfaces/po-decimal-format-result.interface';
 export * from './po-email/po-email.component';
 export * from './po-input/po-input.component';
 export * from './po-input/po-mask';

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

@@ -162,6 +162,20 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
      * Evento disparado quando o valor do *checkbox* for alterado.
      */
     change: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
     /**
      * @optional
      *
@@ -175,6 +189,7 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     disabladTabindex: boolean;
     displayAdditionalHelp: boolean;
     id: string;
+    modelLastUpdate: any;
     propagateChange: any;
     onTouched: any;
     private _disabled?;
@@ -240,6 +255,7 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     registerOnChange(fn: any): void;
     registerOnTouched(fn: any): void;
     writeValue(value: any): void;
+    controlChangeModelEmitter(value: any): void;
     private applySizeBasedOnA11y;
     protected abstract changeModelValue(value: boolean | null): any;
 }

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

@@ -212,6 +212,20 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      * Evento disparado ao alterar valor do campo
      */
     change: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
     /**
      * @optional
      *
@@ -225,6 +239,7 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
     checkedOptionsList: any;
     displayAdditionalHelp: boolean;
     mdColumns: number;
+    modelLastUpdate: any;
     propagateChange: any;
     validatorChange: any;
     private _columns;
@@ -329,6 +344,7 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
     registerOnChange(fn: any): void;
     registerOnTouched(fn: any): void;
     writeValue(optionsModel: any): void;
+    controlChangeModelEmitter(value: any): void;
     registerOnValidatorChange(fn: () => void): void;
     validate(abstractControl: AbstractControl): {
         [key: string]: any;

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

@@ -314,6 +314,20 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      * > Pode-se optar pelo recebimento do objeto selecionado ao invés do model através da propriedade `p-emit-object-value`.
      */
     change: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
     /**
      * @optional
      *
@@ -395,6 +409,7 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
     isFirstFilter: boolean;
     isFiltering: boolean;
     keyupSubscribe: any;
+    modelLastUpdate: any;
     onModelChange: any;
     previousSearchValue: string;
     selectedOption: any;
@@ -677,6 +692,7 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
     private isGroupTitle;
     private updateOptionsSelectedState;
     callModelChange(value: any): any;
+    controlChangeModelEmitter(value: any): void;
     isEqual(value: any, inputValue: any): boolean;
     mapSizeToIcon(size: string): string;
     searchForLabel(search: string, options: Array<any>, filterMode: PoComboFilterMode): void;

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

@@ -64,6 +64,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     outerContainer: ElementRef;
     containerElement: ElementRef;
     contentElement: ElementRef;
+    fieldContainerInput: ElementRef;
     iconElement: ElementRef;
     inputEl: ElementRef;
     poListbox: PoListBoxComponent;

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

@@ -239,6 +239,20 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
      */
     additionalHelp: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
     /**
      * @optional
      *
@@ -286,6 +300,7 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * @default `false`
      */
     labelTextWrap: import("@angular/core").InputSignal<boolean>;
+    modelLastUpdate: any;
     offset: number;
     protected firstStart: boolean;
     protected hour: string;
@@ -468,6 +483,7 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
     formatToDate(value: Date): string;
     controlModel(date: Date): void;
     callOnChange(value: any, retry?: boolean): void;
+    controlChangeModelEmitter(value: any): void;
     mapSizeToIcon(size: string): string;
     setDisabledState(isDisabled: boolean): void;
     registerOnChange(func: any): void;

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

@@ -290,6 +290,20 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      * Evento disparado ao alterar valor do campo.
      */
     onChange: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
     /**
      * @optional
      *
@@ -301,6 +315,7 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     errorMessage: string;
     dateRange: PoDatepickerRange;
     displayAdditionalHelp: boolean;
+    modelLastUpdate: any;
     protected format: any;
     protected isDateRangeInputFormatValid: boolean;
     protected isStartDateRangeInputValid: boolean;
@@ -514,6 +529,7 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     protected buildMask(format?: string): PoMask;
     protected dateFormatFailed(value: string): boolean;
     protected updateModel(value: any): void;
+    controlChangeModelEmitter(value: any): void;
     protected validateModel(value: any): void;
     protected verifyValidDate(startDate: string, endDate: string): boolean;
     private convertPatternDateFormat;

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

@@ -456,6 +456,21 @@ export declare abstract class PoDatetimepickerBaseComponent implements ControlVa
      * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
      */
     keydown: EventEmitter<KeyboardEvent>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
+    modelLastUpdate: any;
     constructor(languageService: PoLanguageService);
     writeValue(value: any): void;
     registerOnChange(fn: any): void;
@@ -487,6 +502,7 @@ export declare abstract class PoDatetimepickerBaseComponent implements ControlVa
     getModelValue(): string;
     getTimezoneOffset(date?: Date): string;
     callOnChange(value: any, retry?: boolean): void;
+    controlChangeModelEmitter(value: any): void;
     controlModel(): void;
     formatTimeForDisplay(time: string): string;
     protected buildMask(format?: string): PoMask;

package/lib/components/po-field/po-decimal/interfaces/po-decimal-format-parsed.interface.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @docsPrivate
+ *
+ * @description
+ *
+ * Resultado do parsing de uma string de formato numérico.
+ */
+export interface PoDecimalFormatParsed {
+    integerFormat: Array<string>;
+    decimalFormat: Array<string>;
+    groupSeparatorPositions: Array<number>;
+    allowNegative: boolean;
+    integerDigitCount: number;
+    decimalDigitCount: number;
+    originalFormat: string;
+}

package/lib/components/po-field/po-decimal/interfaces/po-decimal-format-result.interface.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @docsPrivate
+ *
+ * @description
+ *
+ * Resultado da aplicação do formato numérico a um valor.
+ */
+export interface PoDecimalFormatResult {
+    viewValue: string;
+    modelValue: number | undefined;
+    isValid: boolean;
+}

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

@@ -1,4 +1,4 @@
-import { AfterViewInit, ElementRef, OnDestroy, OnInit, OnChanges, SimpleChanges } from '@angular/core';
+import { AfterViewInit, ElementRef, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputBaseComponent } from '../po-input/po-input-base.component';
 /**
@@ -39,6 +39,11 @@ import { PoInputBaseComponent } from '../po-input/po-input-base.component';
  *  <file name="sample-po-decimal-hourly-wage-reactive-form/sample-po-decimal-hourly-wage-reactive-form.component.html"> </file>
  *  <file name="sample-po-decimal-hourly-wage-reactive-form/sample-po-decimal-hourly-wage-reactive-form.component.ts"> </file>
  * </example>
+ *
+ * <example name="po-decimal-display-format" title="PO Decimal - Display Format">
+ *  <file name="sample-po-decimal-display-format/sample-po-decimal-display-format.component.html"> </file>
+ *  <file name="sample-po-decimal-display-format/sample-po-decimal-display-format.component.ts"> </file>
+ * </example>
  */
 export declare class PoDecimalComponent extends PoInputBaseComponent implements AfterViewInit, OnInit, OnDestroy, OnChanges {
     private readonly el;
@@ -72,6 +77,7 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
      * - A soma total de `p-decimals-length` com `p-thousand-maxlength` limita-se à 16;
      * - Esta propriedade sobrepõe apenas o valor **padrão** de `p-thousand-maxlength`;
      * - Caso `p-thousand-maxlength` tenha um valor definido, esta propriedade poderá receber apenas o valor restante do limite total (16).
+     * - Quando utilizado com `p-display-format`, será respeitado o valor **mais restritivo** entre esta propriedade e o número de casas decimais definido no formato.
      *
      * @default `2`
      */
@@ -88,6 +94,8 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
      * - O valor máximo permitido é 13;
      * - A soma total de `p-decimals-length` com `p-thousand-maxlength` limita-se à 16;
      * - Esta propriedade sobrepõe o valor definido em `p-decimals-length`.
+     * - Quando utilizado com `p-display-format`, será respeitado o valor **mais restritivo** entre esta propriedade e o número de dígitos inteiros definido no
+     * formato.
      *
      * @default `13`
      */
@@ -105,6 +113,31 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
      *
      */
     set locale(locale: string);
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define uma máscara de formatação numérica avançada para o campo.
+     *
+     * Simbologia suportada:
+     * - `9`: Dígito obrigatório (preenche com zero à esquerda no blur);
+     * - `>`: Supressão de zero à esquerda (dígito não obrigatório);
+     * - `<`: Decimal flutuante, supressão de zeros à direita (dígito não obrigatório);
+     * - `,` e `.`: Separadores de milhar/grupo e decimal (convertidos conforme `p-locale`);
+     * - `-`: Sinal negativo (deve ser o primeiro caractere do formato).
+     *
+     * > **Importante:**
+     * - A formatação via `p-display-format` é apenas visual; o valor do model é sempre o número puro.
+     * - Quando o valor pré-preenchido não atende ao formato (overflow ou negativo sem `-`), o campo exibe com a formatação padrão do `po-decimal` (separadores de milhar + `p-decimals-length` casas decimais).
+     * - Quando `p-decimals-length` ou `p-thousand-maxlength` são definidos, será respeitado o valor **mais restritivo** entre o formato e a propriedade.
+     * - Incompatível com `p-mask`, `p-mask-format-model`, `p-mask-no-length-validation` e `p-pattern`.
+     *
+     * Exemplos de formato: `>>>,>>>,>>9.99`, `->>,>>9.99`, `999.9`, `>>>,>>9.9<<<<<<`
+     *
+     */
+    readonly displayFormat: import("@angular/core").InputSignal<string>;
+    private readonly formatParsed;
     /**
      * @optional
      *
@@ -152,6 +185,14 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
         hideAdditionalHelp: boolean;
         helperSettings?: any;
     };
+    private applyFormatOnBlur;
+    private resolveViewValue;
+    private applyFormatOnBlurAndSetView;
+    private formatMaskWithAblPositions;
+    private validateFormatOnInput;
+    private getEffectiveFormatParsed;
+    private getModelValueFromView;
+    private refreshOnPropertyChange;
     private containsComma;
     private containsMoreThanOneDecimalSeparator;
     private controlChangeEmitter;

package/lib/components/po-field/po-decimal/utils/po-decimal-format.util.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Formatação numérica avançada para o po-decimal.
+ *
+ * Simbologia suportada:
+ *  9 - Dígito obrigatório (preenche com zero)
+ *  > - Supressão de zero à esquerda
+ *  < - Supressão de zeros à direita (decimal flutuante)
+ *  , - Separador de grupo (convertido conforme locale)
+ *  . - Separador decimal (convertido conforme locale)
+ *  - - Sinal negativo (primeiro caractere)
+ */
+import { PoDecimalFormatParsed } from '../interfaces/po-decimal-format-parsed.interface';
+import { PoDecimalFormatResult } from '../interfaces/po-decimal-format-result.interface';
+export { PoDecimalFormatParsed } from '../interfaces/po-decimal-format-parsed.interface';
+export { PoDecimalFormatResult } from '../interfaces/po-decimal-format-result.interface';
+/**
+ * Aplica o formato ao valor numérico, gerando a representação visual.
+ *
+ * @returns viewValue formatado + flag de validação (overflow = isValid false)
+ */
+export declare function applyDecimalFormat(value: number | undefined | null, parsed: PoDecimalFormatParsed, decimalSeparator: string, thousandSeparator: string): PoDecimalFormatResult;
+/**
+ * Deriva os limites de dígitos do formato para compatibilidade com p-decimals-length / p-thousand-maxlength.
+ */
+export declare function getFormatLimits(parsed: PoDecimalFormatParsed): {
+    decimalsLength: number;
+    thousandMaxlength: number;
+} | null;
+/**
+ * Faz o parsing da string de formato numérico.
+ *
+ * Regra: '.' no formato = separador decimal, ',' = separador de grupo.
+ * Sem '.' = formato puramente inteiro.
+ */
+export declare function parseDecimalFormat(format: string): PoDecimalFormatParsed;
+/**
+ * Valida se o valor digitado cabe no formato (usado durante input em tempo real).
+ */
+export declare function validateAgainstFormat(rawValue: string, parsed: PoDecimalFormatParsed, decimalSeparator: string): boolean;
+/**
+ * Insere separadores de grupo baseando-se nas posições do formato original,
+ * calculando da direita para a esquerda. Funciona tanto com formato truncado
+ * (quando p-thousand-maxlength restringe) quanto em tamanho completo.
+ *
+ * Aceita digits como Array<string> (blur, com placeholders) ou string (digitação).
+ */
+export declare function insertGroupSeparatorsFromRight(digits: Array<string> | string, parsed: PoDecimalFormatParsed, thousandSeparator: string): string;

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

@@ -308,7 +308,13 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      *
      * @description
      *
-     * Evento disparado ao alterar valor do model.
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
      */
     changeModel: EventEmitter<any>;
     /**

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

@@ -470,6 +470,20 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      *  Por parâmetro será passado o novo valor.
      */
     change: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
     /**
      * @optional
      *
@@ -492,6 +506,7 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     columnRestoreManager: EventEmitter<string[]>;
     displayAdditionalHelp: boolean;
     service: any;
+    modelLastUpdate: any;
     protected selectedOptions: any[];
     protected getSubscription: Subscription;
     protected keysDescription: Array<any>;
@@ -636,6 +651,7 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     registerOnTouched(func: any): void;
     selectValue(valueSelected: any): void;
     callOnChange(value: any): void;
+    controlChangeModelEmitter(value: any): void;
     mapSizeToIcon(size: string): string;
     searchById(value: any): void;
     validate(abstractControl: AbstractControl): {

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

@@ -233,6 +233,20 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      * Pode ser informada uma função que será disparada quando houver alterações no ngModel.
      */
     change: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
     /**
      * @optional
      *
@@ -306,6 +320,7 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
     service: PoMultiselectFilterService;
     defaultService: PoMultiselectFilterService;
     displayAdditionalHelp: boolean;
+    modelLastUpdate: any;
     protected onModelTouched: any;
     protected clickOutListener: () => void;
     protected resizeListener: () => void;
@@ -585,6 +600,7 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
     updateList(options: Array<PoMultiselectOption | any>): void;
     callOnChange(selectedOptions: Array<PoMultiselectOption | any>): void;
     eventChange(selectedOptions: any): void;
+    controlChangeModelEmitter(value: any): void;
     getValuesFromOptions(selectedOptions: Array<PoMultiselectOption | any>): any[];
     getLabelByValue(value: any): any;
     mapSizeToIcon(size: string): string;

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

@@ -214,6 +214,20 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
      * Evento ao alterar valor do campo.
      */
     change: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
     /**
      * @optional
      *
@@ -224,6 +238,7 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
     keydown: EventEmitter<KeyboardEvent>;
     displayAdditionalHelp: boolean;
     mdColumns: number;
+    modelLastUpdate: any;
     value: any;
     protected readonly cd: ChangeDetectorRef;
     protected onTouched: any;
@@ -305,6 +320,7 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
     set size(value: string);
     get size(): string;
     protected onThemeChange(): void;
+    controlChangeModelEmitter(value: any): void;
     changeValue(changedValue: any): void;
     setDisabledState(isDisabled: boolean): void;
     registerOnChange(fn: any): void;

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

@@ -88,6 +88,20 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
      * Evento disparado ao sair do campo.
      */
     blur: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
     /**
      * @optional
      *
@@ -155,6 +169,7 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
     displayValue: any;
     id: string;
     modelValue: any;
+    modelLastUpdate: any;
     selectedValue: any;
     optionsDefault: any[];
     listGroupOptions: any[];
@@ -345,6 +360,7 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
         hideAdditionalHelp: boolean;
         helperSettings?: any;
     };
+    controlChangeModelEmitter(value: any): void;
     private isEqual;
     private findOptionValue;
     private getValueUpdate;

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

@@ -1,4 +1,4 @@
-import { AfterViewInit, ElementRef, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
+import { AfterViewInit, ElementRef, EventEmitter, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl, ValidationErrors, Validator } from '@angular/forms';
 import { PoFieldModel } from '../po-field.model';
 import { PoSwitchLabelPosition } from './po-switch-label-position.enum';
@@ -262,6 +262,21 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
      * @default `false`
      */
     labelTextWrap: import("@angular/core").InputSignal<boolean>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado sempre que o valor do model é alterado, seja por interação do usuário
+     * ou por atualização programática (ex: `setValue`, `patchValue`, carregamento assíncrono).
+     *
+     * Diferentemente do `p-change`, que é disparado apenas por interação do usuário,
+     * o `p-change-model` cobre todos os cenários de alteração de valor.
+     *
+     * Não emite quando o novo valor é idêntico ao anterior (deduplicação automática).
+     */
+    changeModel: EventEmitter<any>;
+    modelLastUpdate: any;
     private readonly el;
     private readonly injectOptions;
     private control;
@@ -327,5 +342,6 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
      * ```
      */
     showAdditionalHelp(): boolean;
+    controlChangeModelEmitter(value: any): void;
     private applySizeBasedOnA11y;
 }