@po-ui/ng-components 21.24.0 → 21.26.0

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

@@ -331,10 +331,10 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
     get placeholder(): string;
     /** Desabilita o campo. */
     disabled?: boolean;
-    set setDisabled(disabled: string);
+    set setDisabled(disabled: boolean);
     /** Torna o elemento somente leitura. */
     readonly?: boolean;
-    set setReadonly(readonly: string);
+    set setReadonly(readonly: boolean);
     /**
      * @optional
      *
@@ -345,7 +345,7 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * @default `false`
      */
     required?: boolean;
-    set setRequired(required: string);
+    set setRequired(required: boolean);
     /**
      * Define se a indicação de campo obrigatório será exibida.
      *
@@ -371,7 +371,7 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
     get size(): string;
     /** Habilita ação para limpar o campo. */
     clean?: boolean;
-    set setClean(clean: string);
+    set setClean(clean: boolean);
     /**
      * @optional
      *

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

@@ -371,7 +371,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      * @default `false`
      */
     disabled?: boolean;
-    set setDisabled(disabled: string);
+    set setDisabled(disabled: boolean);
     /**
      * @optional
      *
@@ -385,7 +385,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     get isDisabled(): boolean;
     /** Indica que o campo será somente leitura. */
     readonly?: boolean;
-    set setReadonly(readonly: string);
+    set setReadonly(readonly: boolean);
     /**
      * @optional
      *
@@ -397,7 +397,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      * @default `false`
      */
     required?: boolean;
-    set setRequired(required: string);
+    set setRequired(required: boolean);
     /**
      * @optional
      *
@@ -423,7 +423,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     showRequired: boolean;
     /** Se verdadeiro, o campo receberá um botão para ser limpo. */
     clean?: boolean;
-    set setClean(clean: string);
+    set setClean(clean: boolean);
     /**
      * @description
      *
@@ -470,7 +470,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      * @default `false`
      */
     maskFormatModel?: boolean;
-    set setMaskFormatModel(maskFormatModel: string);
+    set setMaskFormatModel(maskFormatModel: boolean);
     /**
      * @optional
      *

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

@@ -208,9 +208,9 @@ export declare abstract class PoTimepickerBaseComponent implements ControlValueA
      */
     set placeholder(placeholder: string);
     get placeholder(): string;
-    set setDisabled(disabled: string);
-    set setReadonly(readonly: string);
-    set setRequired(required: string);
+    set setDisabled(disabled: boolean);
+    set setReadonly(readonly: boolean);
+    set setRequired(required: boolean);
     /** Define se a indicação de campo obrigatório será exibida. */
     showRequired: boolean;
     /**
@@ -226,7 +226,7 @@ export declare abstract class PoTimepickerBaseComponent implements ControlValueA
      */
     set size(value: string);
     get size(): string;
-    set setClean(clean: string);
+    set setClean(clean: boolean);
     /**
      * @optional
      *

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

@@ -0,0 +1,16 @@
+/**
+ * @docsPrivate
+ *
+ * @description
+ *
+ * Interface interna para configuração de ações customizadas no po-helper.
+ * Utilizada exclusivamente para repasse de configuração entre os componentes de página (po-page-default, po-page-header) e o po-helper.
+ */
+export interface PoHelperCustomAction {
+    /** Ícone a ser exibido no botão. */
+    icon: string;
+    /** Label de acessibilidade para o botão. */
+    ariaLabel?: string;
+    /** Função callback a ser executada ao clicar no botão. */
+    action: Function;
+}

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

@@ -1,4 +1,5 @@
 import { PoHelperOptions } from './interfaces/po-helper.interface';
+import { PoHelperCustomAction } from './interfaces/po-helper-custom-action.interface';
 /**
  * @description
  *
@@ -74,6 +75,8 @@ export declare class PoHelperBaseComponent {
      *
      */
     helper: import("@angular/core").InputSignal<string | PoHelperOptions>;
+    /** @docsPrivate */
+    customAction: import("@angular/core").InputSignal<PoHelperCustomAction>;
     /**
      * @optional
      *

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

@@ -1,7 +1,7 @@
-import { ElementRef, AfterViewInit, OnDestroy, OnChanges, SimpleChanges, ChangeDetectorRef } from '@angular/core';
+import { OnDestroy, OnChanges, ElementRef, AfterViewInit, SimpleChanges, ChangeDetectorRef } from '@angular/core';
+import { PoButtonComponent } from '../po-button';
 import { PoHelperBaseComponent } from './po-helper-base.component';
 import { PoPopoverComponent } from '../po-popover/po-popover.component';
-import { PoButtonComponent } from '../po-button';
 import { PoTextFragment } from '../../utils/safe-text-parser';
 /**
  * @docsExtends PoHelperBaseComponent
@@ -29,6 +29,7 @@ export declare class PoHelperComponent extends PoHelperBaseComponent implements
     target: ElementRef;
     popover: PoPopoverComponent;
     poButton: PoButtonComponent;
+    refreshAnimating: boolean;
     private static instances;
     private static idCounter;
     protected popoverPosition: string;
@@ -38,7 +39,6 @@ export declare class PoHelperComponent extends PoHelperBaseComponent implements
     protected readonly contentFragments: import("@angular/core").Signal<PoTextFragment[]>;
     constructor(cdr: ChangeDetectorRef);
     ngAfterViewInit(): void;
-    setPopoverPositionByScreen(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     openHelperPopover(): void;
@@ -51,4 +51,6 @@ export declare class PoHelperComponent extends PoHelperBaseComponent implements
     protected ariaLabel(): string;
     protected handleOpen(): void;
     protected handleClose(): void;
+    protected executeCustomAction(event: Event): void;
+    protected onRefreshAnimationEnd(): void;
 }

package/lib/components/po-page/po-page-default/po-page-default-base.component.d.ts

@@ -1,11 +1,12 @@
-import { PoLanguageService } from './../../../services/po-language/po-language.service';
-import { PoBreadcrumb } from '../../po-breadcrumb/po-breadcrumb.interface';
-import { PoHelperOptions } from '../../po-helper/interfaces/po-helper.interface';
+import { PoPageHeaderType } from './enums/po-page-header-type.enum';
 import { PoPageAction } from '../interfaces/po-page-action.interface';
-import { PoPageContentComponent } from '../po-page-content/po-page-content.component';
 import { PoPageActionsLayout } from './enums/po-page-actions-layout.enum';
-import { PoPageHeaderType } from './enums/po-page-header-type.enum';
+import { PoBreadcrumb } from '../../po-breadcrumb/po-breadcrumb.interface';
 import { PoPageDefaultLiterals } from './po-page-default-literals.interface';
+import { PoHelperOptions } from '../../po-helper/interfaces/po-helper.interface';
+import { PoPageContentComponent } from '../po-page-content/po-page-content.component';
+import { PoLanguageService } from './../../../services/po-language/po-language.service';
+import { PoHelperCustomAction } from '../../po-helper/interfaces/po-helper-custom-action.interface';
 export declare const poPageDefaultLiteralsDefault: {
     en: PoPageDefaultLiterals;
     es: PoPageDefaultLiterals;
@@ -18,6 +19,12 @@ export declare const backNavigationAriaLabels: {
     pt: string;
     ru: string;
 };
+export declare const refreshAriaLabels: {
+    en: string;
+    es: string;
+    pt: string;
+    ru: string;
+};
 /**
  * @description
  *
@@ -178,6 +185,27 @@ export declare abstract class PoPageDefaultBaseComponent {
      */
     set pageHeaderType(value: string | PoPageHeaderType);
     get pageHeaderType(): string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define a função de callback executada ao clicar no botão de atualização (refresh) ao lado do subtítulo da página.
+     *
+     * Quando não houver subtítulo (`p-subtitle`), o refresh será exibido logo abaixo do título.
+     *
+     * > Esta propriedade possui precedência sobre a configuração de `p-helper`.
+     *
+     * Exemplo de uso:
+     * ```html
+     * <po-page-default
+     *   p-title="Dashboard"
+     *   [p-refresh]="onRefresh"
+     * ></po-page-default>
+     * ```
+     */
+    refresh: import("@angular/core").InputSignal<Function>;
+    protected readonly refreshCustomAction: import("@angular/core").Signal<PoHelperCustomAction>;
     /**
      * @optional
      *

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

@@ -22,6 +22,11 @@ import { PoPageDefaultBaseComponent } from './po-page-default-base.component';
  *  <file name="sample-po-page-default-dashboard/sample-po-page-default-dashboard.component.css"> </file>
  *  <file name="sample-po-page-default-dashboard/sample-po-page-default-dashboard.service.ts"> </file>
  * </example>
+ *
+ * <example name="po-page-default-refresh" title="PO Page Default - Refresh">
+ *  <file name="sample-po-page-default-refresh/sample-po-page-default-refresh.component.html"> </file>
+ *  <file name="sample-po-page-default-refresh/sample-po-page-default-refresh.component.ts"> </file>
+ * </example>
  */
 export declare class PoPageDefaultComponent extends PoPageDefaultBaseComponent implements AfterContentInit, OnChanges, OnDestroy {
     private readonly renderer;

package/lib/components/po-page/po-page-header/po-page-header-base.component.d.ts

@@ -1,6 +1,7 @@
 import { PoBreadcrumb } from '../../po-breadcrumb/po-breadcrumb.interface';
 import { PoHelperOptions } from '../../po-helper/interfaces/po-helper.interface';
 import { PoTextFragment } from '../../../utils/safe-text-parser';
+import { PoHelperCustomAction } from '../../po-helper/interfaces/po-helper-custom-action.interface';
 /**
  * @docsPrivate
  *
@@ -14,6 +15,8 @@ export declare class PoPageHeaderBaseComponent {
     title: string;
     /** Define o conteúdo do po-helper. */
     helper: import("@angular/core").InputSignal<string | PoHelperOptions>;
+    /** Define a ação customizada para o po-helper (uso interno entre componentes). */
+    customAction: import("@angular/core").InputSignal<PoHelperCustomAction>;
     /** Define o tamanho dos componentes no header. */
     size: string;
     /** Define o tipo de header: `primary`, `secondary` ou `tertiary`. */

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

@@ -32,6 +32,18 @@ export declare class PoPopoverBaseComponent {
      */
     appendBox: boolean;
     cornerAligned: boolean;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o espaçamento (em pixels) entre o componente alvo (`p-target`) e o `po-popover`.
+     * Útil para componentes com targets pequenos (como ícones) onde o espaçamento padrão é
+     * proporcionalmente muito grande e cria desalinhamento visual.
+     *
+     * @default `8`
+     */
+    offset: number;
     /**
      * @description
      *

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

@@ -47,6 +47,7 @@ export declare class PoPopoverComponent extends PoPopoverBaseComponent implement
     debounceResize(): void;
     open(): void;
     private showPopover;
+    private stabilizePopoverWidth;
     ensurePopoverPosition(): void;
     setOpacity(value: number): void;
     setPopoverPosition(): void;

package/lib/components/po-stepper/po-stepper-step/po-stepper-step.component.d.ts

@@ -46,6 +46,6 @@ export declare class PoStepperStepComponent implements OnChanges {
     ngOnChanges(changes: SimpleChanges): void;
     getStatusClass(status: string): string;
     onClick(): void;
-    onEnter(): void;
+    onEnter(event?: KeyboardEvent): void;
     setDefaultStepSize(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@po-ui/ng-components",
-  "version": "21.24.0",
+  "version": "21.26.0",
   "description": "PO UI - Components",
   "author": "PO UI",
   "license": "MIT",
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "@angular/cdk": "~21.2.14",
-    "@po-ui/style": "21.24.0",
-    "@po-ui/ng-schematics": "21.24.0",
+    "@po-ui/style": "21.26.0",
+    "@po-ui/ng-schematics": "21.26.0",
     "driver.js": "~1.4.0",
     "echarts": "^6.1.0",
     "tslib": "^2.6.2"
@@ -39,7 +39,7 @@
     "@angular/platform-browser-dynamic": "^21",
     "@angular/router": "^21",
     "@angular-devkit/schematics": "^21",
-    "@po-ui/style": "21.24.0",
+    "@po-ui/style": "21.26.0",
     "rxjs": "~7.8.1",
     "zone.js": "~0.15.0"
   },

package/schematics/ng-add/index.js

@@ -18,7 +18,7 @@ function default_1(options) {
 }
 function addPoPackageAndInstall() {
     return (tree, context) => {
-        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '21.24.0');
+        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '21.26.0');
         // install packages
         context.addTask(new tasks_1.NodePackageInstallTask());
     };

package/schematics/ng-update/v14/index.js

@@ -6,7 +6,7 @@ const tasks_1 = require("@angular-devkit/schematics/tasks");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v15/index.js

@@ -11,7 +11,7 @@ const changes_1 = require("./changes");
 const httpClientModuleName = 'HttpClientModule';
 const httpClientModuleSourcePath = '@angular/common/http';
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v16/index.js

@@ -6,7 +6,7 @@ const tasks_1 = require("@angular-devkit/schematics/tasks");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v17/index.js

@@ -6,7 +6,7 @@ const tasks_1 = require("@angular-devkit/schematics/tasks");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v18/index.js

@@ -40,11 +40,11 @@ function main(options) {
             configureNewIcon.toLowerCase() === 'y' ||
             configureNewIcon.toLowerCase() === 'sim' ||
             configureNewIcon.toLowerCase() === '') {
-            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion),
                 addImportOnly(options, [IconsDictionaryName, poIconDictionary], poModuleSourcePath),
                 addProviderToAppModule(options, newProviderDictionary),
                 updateAppConfigFileRule(),

package/schematics/ng-update/v19/index.js

@@ -40,11 +40,11 @@ function main(options) {
             configureNewIcon.toLowerCase() === 'y' ||
             configureNewIcon.toLowerCase() === 'sim' ||
             configureNewIcon.toLowerCase() === '') {
-            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion),
                 addImportOnly(options, [IconsDictionaryName, poIconDictionary], poModuleSourcePath),
                 addProviderToAppModule(options, newProviderDictionary),
                 updateAppConfigFileRule(),

package/schematics/ng-update/v2/index.js

@@ -10,7 +10,7 @@ const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function updateToV2() {
     return (0, schematics_1.chain)([
-        updatePackageJson('21.24.0', changes_1.dependeciesChanges),
+        updatePackageJson('21.26.0', changes_1.dependeciesChanges),
         (0, replace_1.replaceInFile)('tslint.json', changes_1.tsLintReplaces),
         (0, replace_1.replaceInFile)('angular.json', changes_1.angularJsonReplaces),
         createUpgradeRule(),

package/schematics/ng-update/v20/index.js

@@ -40,11 +40,11 @@ function main(options) {
             configureNewIcon.toLowerCase() === 'y' ||
             configureNewIcon.toLowerCase() === 'sim' ||
             configureNewIcon.toLowerCase() === '') {
-            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion),
                 addImportOnly(options, [IconsDictionaryName, poIconDictionary], poModuleSourcePath),
                 addProviderToAppModule(options, newProviderDictionary),
                 updateAppConfigFileRule(),

package/schematics/ng-update/v21/index.js

@@ -9,7 +9,7 @@ const project_1 = require("@po-ui/ng-schematics/project");
 const changes_1 = require("./changes");
 function main() {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
-        return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+        return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
     });
 }
 function default_1() {

package/schematics/ng-update/v3/index.js

@@ -7,7 +7,7 @@ const project_1 = require("@po-ui/ng-schematics/project");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function updateToV3() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v4/index.js

@@ -7,7 +7,7 @@ const project_1 = require("@po-ui/ng-schematics/project");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v5/index.js

@@ -7,7 +7,7 @@ const project_1 = require("@po-ui/ng-schematics/project");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v6/index.js

@@ -6,7 +6,7 @@ const tasks_1 = require("@angular-devkit/schematics/tasks");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.24.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.26.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {