refactor(navbar): marca componente po-navbar como depreciado

Marca o componente `po-navbar` como @deprecated,
indicando que ele será removido em versões futuras.
A recomendação é utilizar o `po-header`.

fixes DTHFUI-11848

BREAKING CHANGE: marca componente `po-navbar` como @deprecated

O componente `po-navbar` não será mais mantido e
será removido em versões futuras.
A alternativa recomendada é utilizar o `po-header`.

Author: anabye

docs/guides/deprecations.md

@@ -25,6 +25,11 @@ A tabela a seguir lista todos os recursos depreciados, organizados pelo release
         </tr>
       </thead>
       <tbody>
+      <tr class="po-table-row">
+        <th class="po-table-column"><a href="documentation/po-navbar">PoNavbar</a></th>
+          <td class="po-table-column">Componente descontinuado</td>
+          <td class="po-table-column" style="text-align: center;">v23</td>
+        </tr>
         <tr class="po-table-row">
           <th class="po-table-column"><a href="documentation/po-tabs">PoTabs</a></th>
           <td class="po-table-column">p-small</td>
@@ -201,7 +206,13 @@ export class AppModule { }
         </tr>
       </thead>
       <tbody>
-      <tr class="po-table-row">
+        <tr class="po-table-row">
+          <th class="po-table-column"><a href="documentation/po-navbar">PoNavbar</a></th>
+          <td class="po-table-column">Componente descontinuado</td>
+          <td class="po-table-column"><a href="documentation/po-header">PoHeader</a></td>
+          <td class="po-table-column" style="text-align: center;">v23</td>
+        </tr>
+        <tr class="po-table-row">
           <th class="po-table-column"><a href="documentation/po-tabs">PoTabs</a></th>
           <td class="po-table-column">p-small</td>
           <td class="po-table-column">-</td>

projects/ui/src/lib/components/po-navbar/interfaces/po-navbar-icon-action.interface.ts

@@ -1,6 +1,8 @@
 import { TemplateRef } from '@angular/core';
 
 /**
+ * @deprecated v23.x.x
+ *
  * @usedBy PoNavbarComponent
  *
  * @description

projects/ui/src/lib/components/po-navbar/interfaces/po-navbar-item.interface.ts

@@ -1,4 +1,6 @@
 /**
+ * @deprecated v23.x.x
+ *
  * @usedBy PoNavbarComponent
  *
  * @description

projects/ui/src/lib/components/po-navbar/interfaces/po-navbar-literals.interface.ts

@@ -1,4 +1,6 @@
 /**
+ * @deprecated v23.x.x
+ *
  * @usedBy PoNavbarComponent
  *
  * @description

projects/ui/src/lib/components/po-navbar/po-navbar-base.component.ts

@@ -48,6 +48,8 @@ export abstract class PoNavbarBaseComponent {
   private language: string = poLocaleDefault;
 
   /**
+   * @deprecated v23.x.x
+   *
    * @optional
    *
    * @description
@@ -63,6 +65,8 @@ export abstract class PoNavbarBaseComponent {
   }
 
   /**
+   * @deprecated v23.x.x
+   *
    * @optional
    *
    * @description
@@ -78,6 +82,8 @@ export abstract class PoNavbarBaseComponent {
   }
 
   /**
+   * @deprecated v23.x.x
+   *
    * @optional
    *
    * @description
@@ -119,6 +125,8 @@ export abstract class PoNavbarBaseComponent {
   }
 
   /**
+   * @deprecated v23.x.x
+   *
    * @optional
    *
    * @description
@@ -137,6 +145,8 @@ export abstract class PoNavbarBaseComponent {
   }
 
   /**
+   * @deprecated v23.x.x
+   *
    * @optional
    *
    * @description
@@ -151,6 +161,8 @@ export abstract class PoNavbarBaseComponent {
   @Input('p-logo-alt') logoAlt?: string;
 
   /**
+   * @deprecated v23.x.x
+   *
    * @optional
    *
    * @description

projects/ui/src/lib/components/po-navbar/po-navbar.component.ts

@@ -30,6 +30,8 @@ const poNavbarMatchMedia = `(max-width: ${poNavbarMenuMedia}px)`;
 const poNavbarTiming = '250ms ease';
 
 /**
+ * @deprecated v23.x.x use `po-header`
+ *
  * @docsExtends PoNavbarBaseComponent
  */
 @Component({

projects/ui/src/lib/components/po-navbar/po-navbar.module.ts

@@ -11,12 +11,17 @@ import { PoNavbarLogoComponent } from './po-navbar-logo/po-navbar-logo.component
 import { PoNavbarComponent } from './po-navbar.component';
 
 /**
+ * @deprecated v23.x.x use `po-header`
+ *
  * @description
  *
  * Módulo do componente `po-navbar`.
- *
+ * > Esse componente está **depreciado** e será removido na `v23.x.x`. Recomendamos utilizar o componente
+ * [po-header](https://po-ui.io/documentation/po-header), que oferece compatibilidade com todas as funcionalidades do
+ * `po-navbar`, além de maior flexibilidade, usabilidade e acessibilidade.
+ * >
  * > Para o correto funcionamento do componente `po-navbar`, deve ser importado o módulo `BrowserAnimationsModule` no
- * > módulo principal da sua aplicação.
+ * módulo principal da sua aplicação.
  *
  * Módulo da aplicação:
  * ```