@po-ui/ng-components 21.16.0 → 21.17.0

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

@@ -1,12 +1,9 @@
 /**
- * @usedBy PoHelperComponent
+ * @usedBy PoHelperComponent, PoPageDefaultComponent
  *
  * @description
  *
- * *Interface* que define as opções de configuração do componente po-helper.
- *
- * Permite customizar o conteúdo, título, tipo do ícone, modo de abertura do popover, ações customizadas e eventos.
- *
+ * Interface para configuração das opções de ajuda (*helper*).
  */
 export interface PoHelperOptions {
     /**
@@ -25,6 +22,14 @@ export interface PoHelperOptions {
      * @description
      *
      * Texto explicativo exibido no popover.
+     *
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * content: 'Texto <b>importante</b> com <em>destaque</em> e <u>sublinhado</u>'
+     * ```
      */
     content?: string;
     /**

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

@@ -2,6 +2,7 @@ import { ElementRef, AfterViewInit, OnDestroy, OnChanges, SimpleChanges, ChangeD
 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
  *
@@ -34,6 +35,7 @@ export declare class PoHelperComponent extends PoHelperBaseComponent implements
     id: string;
     private boundFocusIn;
     private readonly poHelperLiterals;
+    protected readonly contentFragments: import("@angular/core").Signal<PoTextFragment[]>;
     constructor(cdr: ChangeDetectorRef);
     ngAfterViewInit(): void;
     setPopoverPositionByScreen(): void;

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

@@ -1,5 +1,6 @@
 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 { 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';
@@ -99,6 +100,30 @@ export declare abstract class PoPageDefaultBaseComponent {
      */
     set componentsSize(value: string);
     get componentsSize(): string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o conteúdo do po-helper informativo exibido ao lado do subtítulo da página.
+     *
+     * Quando não houver subtítulo (`p-subtitle`), o po-helper será exibido logo abaixo do título.
+     *
+     * Aceita uma string simples (exibida como conteúdo) ou um objeto do tipo `PoHelperOptions`
+     * para configuração avançada (título, conteúdo, tipo, ações).
+     *
+     * Exemplo de uso:
+     * ```html
+     * <po-page-default
+     *   p-title="Cadastro"
+     *   p-subtitle="Preencha os dados"
+     *   [p-helper]="{ title: 'Ajuda', content: 'Informações sobre o cadastro' }"
+     * ></po-page-default>
+     * ```
+     *
+     * @default `info`
+     */
+    helper: import("@angular/core").InputSignalWithTransform<string | PoHelperOptions, string | PoHelperOptions>;
     /**
      * @optional
      *
@@ -169,7 +194,15 @@ export declare abstract class PoPageDefaultBaseComponent {
      *
      * Define um texto de apoio ou informações adicionais logo abaixo do título principal.
      *
-     * > Requer que`p-title` esteja definido.
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * subtitle = 'Texto <b>importante</b> com <em>destaque</em> e <u>sublinhado</u>';
+     * ```
+     *
+     * > Requer que `p-title` esteja definido.
      */
     set subtitle(value: string);
     get subtitle(): string;
@@ -186,6 +219,7 @@ export declare abstract class PoPageDefaultBaseComponent {
     constructor(languageService: PoLanguageService);
     protected onThemeChange(): void;
     private applySizeBasedOnA11y;
+    private transformPageHelper;
     abstract setDropdownActions(): any;
     abstract getVisibleActions(): any;
 }

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

@@ -133,7 +133,17 @@ export declare class PoPageDetailBaseComponent {
      *
      * @description
      *
-     * Subtitulo do Header da página
+     * Subtitulo do Header da página.
+     *
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * subtitle = 'Status: <b>Active</b> | Role: <i>Administrator</i>';
+     * ```
+     *
+     * > Requer que `p-title` esteja definido.
      */
     subtitle: string;
     constructor(languageService: PoLanguageService);

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

@@ -139,7 +139,17 @@ export declare class PoPageEditBaseComponent {
      *
      * @description
      *
-     * Subtitulo do Header da página
+     * Subtitulo do Header da página.
+     *
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * subtitle = 'Fields marked with <b>*</b> are <u>required</u>';
+     * ```
+     *
+     * > Requer que `p-title` esteja definido.
      */
     subtitle: string;
     constructor(languageService: PoLanguageService);

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

@@ -1,4 +1,6 @@
 import { PoBreadcrumb } from '../../po-breadcrumb/po-breadcrumb.interface';
+import { PoHelperOptions } from '../../po-helper/interfaces/po-helper.interface';
+import { PoTextFragment } from '../../../utils/safe-text-parser';
 /**
  * @docsPrivate
  *
@@ -10,14 +12,20 @@ import { PoBreadcrumb } from '../../po-breadcrumb/po-breadcrumb.interface';
 export declare class PoPageHeaderBaseComponent {
     /** Título da página. */
     title: string;
+    /** Define o conteúdo do po-helper. */
+    helper: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /** Define o tamanho dos componentes no header. */
     size: string;
-    /** Subtítulo da página. */
-    subtitle: string;
     /** Define o tipo de header: `primary`, `secondary` ou `tertiary`. */
     type: string;
     private _breadcrumb;
+    private _subtitle;
+    private _subtitleFragments;
     /** Objeto com propriedades do breadcrumb. */
     set breadcrumb(value: PoBreadcrumb);
     get breadcrumb(): PoBreadcrumb;
+    /** Subtítulo da página. */
+    set subtitle(value: string);
+    get subtitle(): string;
+    get subtitleFragments(): Array<PoTextFragment>;
 }

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

@@ -149,7 +149,17 @@ export declare abstract class PoPageListBaseComponent {
      *
      * @description
      *
-     * Subtitulo do Header da página
+     * Subtitulo do Header da página.
+     *
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * subtitle = 'Manage <b>active</b> and <i>pending</i> processes';
+     * ```
+     *
+     * > Requer que `p-title` esteja definido.
      */
     subtitle: string;
     constructor(languageService: PoLanguageService);

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

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

package/lib/utils/safe-text-parser.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Parser seguro de tags de formatação (`<b>`, `<strong>`, `<i>`, `<em>`, `<u>`).
+ * Não utiliza `innerHTML`. Tags fora da whitelist são removidas (proteção XSS).
+ */
+/** Fragmento de texto com flags de formatação. */
+export interface PoTextFragment {
+    text: string;
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+}
+/** Tags de formatação suportadas. */
+export type PoFormattingTag = 'b' | 'i' | 'u' | 'strong' | 'em';
+/**
+ * Faz o parsing seguro de uma string com tags de formatação.
+ *
+ * O consumidor declara quais tags aceita via `allowedTags` (obrigatório).
+ * Tags não listadas são removidas. Tags aninhadas são suportadas.
+ *
+ * @param content String com possíveis tags de formatação.
+ * @param allowedTags Tags permitidas pelo consumidor.
+ */
+export declare function parseSafeText(content: string, allowedTags: Array<PoFormattingTag>): Array<PoTextFragment>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@po-ui/ng-components",
-  "version": "21.16.0",
+  "version": "21.17.0",
   "description": "PO UI - Components",
   "author": "PO UI",
   "license": "MIT",
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "@angular/cdk": "~21.2.4",
-    "@po-ui/style": "21.16.0",
-    "@po-ui/ng-schematics": "21.16.0",
+    "@po-ui/style": "21.17.0",
+    "@po-ui/ng-schematics": "21.17.0",
     "echarts": "^5.6.0",
     "tslib": "^2.6.2"
   },
@@ -38,7 +38,7 @@
     "@angular/platform-browser-dynamic": "^21",
     "@angular/router": "^21",
     "@angular-devkit/schematics": "^21",
-    "@po-ui/style": "21.16.0",
+    "@po-ui/style": "21.17.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.16.0');
+        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '21.17.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.16.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('21.16.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('21.16.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.dependeciesChanges),
+        updatePackageJson('21.17.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.16.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('21.16.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+        return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.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.16.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.17.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/types/po-ui-ng-components.d.ts

@@ -2251,14 +2251,11 @@ declare class PoListBoxComponent extends PoListBoxBaseComponent implements OnIni
 }
 
 /**
- * @usedBy PoHelperComponent
+ * @usedBy PoHelperComponent, PoPageDefaultComponent
  *
  * @description
  *
- * *Interface* que define as opções de configuração do componente po-helper.
- *
- * Permite customizar o conteúdo, título, tipo do ícone, modo de abertura do popover, ações customizadas e eventos.
- *
+ * Interface para configuração das opções de ajuda (*helper*).
  */
 interface PoHelperOptions {
     /**
@@ -2277,6 +2274,14 @@ interface PoHelperOptions {
      * @description
      *
      * Texto explicativo exibido no popover.
+     *
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * content: 'Texto <b>importante</b> com <em>destaque</em> e <u>sublinhado</u>'
+     * ```
      */
     content?: string;
     /**
@@ -2659,6 +2664,7 @@ declare class PoPopoverComponent extends PoPopoverBaseComponent implements After
     close(): void;
     debounceResize(): void;
     open(): void;
+    private showPopover;
     ensurePopoverPosition(): void;
     setOpacity(value: number): void;
     setPopoverPosition(): void;
@@ -3310,6 +3316,18 @@ declare enum PoButtonSize {
     Large = "large"
 }
 
+/**
+ * Parser seguro de tags de formatação (`<b>`, `<strong>`, `<i>`, `<em>`, `<u>`).
+ * Não utiliza `innerHTML`. Tags fora da whitelist são removidas (proteção XSS).
+ */
+/** Fragmento de texto com flags de formatação. */
+interface PoTextFragment {
+    text: string;
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+}
+
 /**
  * @docsExtends PoHelperBaseComponent
  *
@@ -3342,6 +3360,7 @@ declare class PoHelperComponent extends PoHelperBaseComponent implements AfterVi
     id: string;
     private boundFocusIn;
     private readonly poHelperLiterals;
+    protected readonly contentFragments: i0.Signal<PoTextFragment[]>;
     constructor(cdr: ChangeDetectorRef);
     ngAfterViewInit(): void;
     setPopoverPositionByScreen(): void;
@@ -30051,6 +30070,30 @@ declare abstract class PoPageDefaultBaseComponent {
      */
     set componentsSize(value: string);
     get componentsSize(): string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o conteúdo do po-helper informativo exibido ao lado do subtítulo da página.
+     *
+     * Quando não houver subtítulo (`p-subtitle`), o po-helper será exibido logo abaixo do título.
+     *
+     * Aceita uma string simples (exibida como conteúdo) ou um objeto do tipo `PoHelperOptions`
+     * para configuração avançada (título, conteúdo, tipo, ações).
+     *
+     * Exemplo de uso:
+     * ```html
+     * <po-page-default
+     *   p-title="Cadastro"
+     *   p-subtitle="Preencha os dados"
+     *   [p-helper]="{ title: 'Ajuda', content: 'Informações sobre o cadastro' }"
+     * ></po-page-default>
+     * ```
+     *
+     * @default `info`
+     */
+    helper: i0.InputSignalWithTransform<string | PoHelperOptions, string | PoHelperOptions>;
     /**
      * @optional
      *
@@ -30121,7 +30164,15 @@ declare abstract class PoPageDefaultBaseComponent {
      *
      * Define um texto de apoio ou informações adicionais logo abaixo do título principal.
      *
-     * > Requer que`p-title` esteja definido.
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * subtitle = 'Texto <b>importante</b> com <em>destaque</em> e <u>sublinhado</u>';
+     * ```
+     *
+     * > Requer que `p-title` esteja definido.
      */
     set subtitle(value: string);
     get subtitle(): string;
@@ -30138,10 +30189,11 @@ declare abstract class PoPageDefaultBaseComponent {
     constructor(languageService: PoLanguageService);
     protected onThemeChange(): void;
     private applySizeBasedOnA11y;
+    private transformPageHelper;
     abstract setDropdownActions(): any;
     abstract getVisibleActions(): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPageDefaultBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoPageDefaultBaseComponent, never, never, { "actions": { "alias": "p-actions"; "required": false; }; "breadcrumb": { "alias": "p-breadcrumb"; "required": false; }; "componentsSize": { "alias": "p-components-size"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "pageActionsLayout": { "alias": "p-page-actions-layout"; "required": false; }; "pageHeaderType": { "alias": "p-page-header-type"; "required": false; }; "title": { "alias": "p-title"; "required": false; }; "subtitle": { "alias": "p-subtitle"; "required": false; }; }, { "back": "p-back"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoPageDefaultBaseComponent, never, never, { "actions": { "alias": "p-actions"; "required": false; }; "breadcrumb": { "alias": "p-breadcrumb"; "required": false; }; "componentsSize": { "alias": "p-components-size"; "required": false; }; "helper": { "alias": "p-helper"; "required": false; "isSignal": true; }; "literals": { "alias": "p-literals"; "required": false; }; "pageActionsLayout": { "alias": "p-page-actions-layout"; "required": false; }; "pageHeaderType": { "alias": "p-page-header-type"; "required": false; }; "title": { "alias": "p-title"; "required": false; }; "subtitle": { "alias": "p-subtitle"; "required": false; }; }, { "back": "p-back"; }, never, never, true, never>;
 }
 
 /**
@@ -30336,7 +30388,17 @@ declare class PoPageDetailBaseComponent {
      *
      * @description
      *
-     * Subtitulo do Header da página
+     * Subtitulo do Header da página.
+     *
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * subtitle = 'Status: <b>Active</b> | Role: <i>Administrator</i>';
+     * ```
+     *
+     * > Requer que `p-title` esteja definido.
      */
     subtitle: string;
     constructor(languageService: PoLanguageService);
@@ -30522,7 +30584,17 @@ declare class PoPageEditBaseComponent {
      *
      * @description
      *
-     * Subtitulo do Header da página
+     * Subtitulo do Header da página.
+     *
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * subtitle = 'Fields marked with <b>*</b> are <u>required</u>';
+     * ```
+     *
+     * > Requer que `p-title` esteja definido.
      */
     subtitle: string;
     constructor(languageService: PoLanguageService);
@@ -30574,18 +30646,24 @@ declare class PoPageEditComponent extends PoPageEditBaseComponent {
 declare class PoPageHeaderBaseComponent {
     /** Título da página. */
     title: string;
+    /** Define o conteúdo do po-helper. */
+    helper: i0.InputSignal<string | PoHelperOptions>;
     /** Define o tamanho dos componentes no header. */
     size: string;
-    /** Subtítulo da página. */
-    subtitle: string;
     /** Define o tipo de header: `primary`, `secondary` ou `tertiary`. */
     type: string;
     private _breadcrumb;
+    private _subtitle;
+    private _subtitleFragments;
     /** Objeto com propriedades do breadcrumb. */
     set breadcrumb(value: PoBreadcrumb);
     get breadcrumb(): PoBreadcrumb;
+    /** Subtítulo da página. */
+    set subtitle(value: string);
+    get subtitle(): string;
+    get subtitleFragments(): Array<PoTextFragment>;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPageHeaderBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoPageHeaderBaseComponent, never, never, { "title": { "alias": "p-title"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "subtitle": { "alias": "p-subtitle"; "required": false; }; "type": { "alias": "p-type"; "required": false; }; "breadcrumb": { "alias": "p-breadcrumb"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoPageHeaderBaseComponent, never, never, { "title": { "alias": "p-title"; "required": false; }; "helper": { "alias": "p-helper"; "required": false; "isSignal": true; }; "size": { "alias": "p-size"; "required": false; }; "type": { "alias": "p-type"; "required": false; }; "breadcrumb": { "alias": "p-breadcrumb"; "required": false; }; "subtitle": { "alias": "p-subtitle"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -31691,7 +31769,17 @@ declare abstract class PoPageListBaseComponent {
      *
      * @description
      *
-     * Subtitulo do Header da página
+     * Subtitulo do Header da página.
+     *
+     * Suporta formatação básica com as tags `<b>` (negrito), `<strong>` (negrito), `<i>` (itálico), `<em>` (itálico) e
+     * `<u>` (sublinhado).
+     *
+     * Exemplo:
+     * ```typescript
+     * subtitle = 'Manage <b>active</b> and <i>pending</i> processes';
+     * ```
+     *
+     * > Requer que `p-title` esteja definido.
      */
     subtitle: string;
     constructor(languageService: PoLanguageService);
@@ -31774,7 +31862,7 @@ declare class PoPageListComponent extends PoPageListBaseComponent implements Aft
  */
 declare class PoPageModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPageModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoPageModule, [typeof PoPageComponent, typeof PoPageContentComponent, typeof PoPageDefaultComponent, typeof PoPageDetailComponent, typeof PoPageEditComponent, typeof PoPageHeaderComponent, typeof PoPageListComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.RouterModule, typeof PoBreadcrumbModule, typeof PoButtonModule, typeof PoDisclaimerGroupModule, typeof PoDropdownModule, typeof PoFieldModule, typeof PoIconModule, typeof PoLanguageModule, typeof PoModalModule, typeof PoPageSlideModule], [typeof PoPageDefaultComponent, typeof PoPageDetailComponent, typeof PoPageEditComponent, typeof PoPageListComponent, typeof PoPageSlideComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoPageModule, [typeof PoPageComponent, typeof PoPageContentComponent, typeof PoPageDefaultComponent, typeof PoPageDetailComponent, typeof PoPageEditComponent, typeof PoPageHeaderComponent, typeof PoPageListComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.RouterModule, typeof PoBreadcrumbModule, typeof PoButtonModule, typeof PoDisclaimerGroupModule, typeof PoDropdownModule, typeof PoFieldModule, typeof PoHelperModule, typeof PoIconModule, typeof PoLanguageModule, typeof PoModalModule, typeof PoPageSlideModule], [typeof PoPageDefaultComponent, typeof PoPageDetailComponent, typeof PoPageEditComponent, typeof PoPageListComponent, typeof PoPageSlideComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoPageModule>;
 }