feat(icon): anuncia depreciação

A Lib Po Icon está depreciada e será removida na v20 do PO UI.

Fixes DTHFUI-9008

BREAKING CHANGE: Depreciação da Lib Po Icon
A Lib Po Icon está depreciada e será removida na v20 do PO UI.

Antes:

É possível usar qualquer um dos ícones da [Lib PO Icon](/guides/icons).

Depois:

Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme documentação.

projects/templates/src/lib/components/po-page-dynamic-table/interfaces/po-page-dynamic-table-custom-action.interface.ts

@@ -48,12 +48,18 @@ export interface PoPageDynamicTableCustomAction {
    *
    * Define um ícone que será exibido ao lado esquerdo do rótulo.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-component
    *  [p-property]="[{ label: 'PO ICON', icon: 'po-icon-news' }]">
    * </po-component>
    * ```
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    *
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca Font Awesome, da seguinte forma:
    * ```

projects/templates/src/lib/components/po-page-dynamic-table/interfaces/po-page-dynamic-table-custom-table-action.interface.ts

@@ -57,13 +57,19 @@ export interface PoPageDynamicTableCustomTableAction {
    *
    * Define um ícone que será exibido ao lado esquerdo do rótulo.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-component
    *  [p-property]="[{ label: 'PO ICON', icon: 'po-icon-news' }]">
    * </po-component>
    * ```
    *
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca Font Awesome, da seguinte forma:
    * ```
    * <po-component

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

@@ -88,10 +88,17 @@ export class PoBadgeBaseComponent {
    * ```
    * <po-badge [p-icon]="true"></po-badge>
    * ```
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-badge p-icon="po-icon-user"></po-badge>
    * ```
+   *
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * <po-badge p-icon="fa fa-podcast"></po-badge>

projects/ui/src/lib/components/po-button-group/po-button-group-item.interface.ts

@@ -22,12 +22,18 @@ export interface PoButtonGroupItem {
   /**
    * Ícone exibido ao lado esquerdo do label do botão.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * buttons: Array<PoButtonGroupItem> = [
    *  { label: 'Button 1', action: this.action.bind(this), icon: 'po-icon-user' },
    * ];
    * ```
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * buttons: Array<PoButtonGroupItem> = [

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

@@ -86,10 +86,16 @@ export class PoButtonBaseComponent {
    * @description
    * Ícone exibido ao lado esquerdo do label do botão.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-button p-icon="po-icon-user" p-label="PO button"></po-button>
    * ```
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * <po-button p-icon="fa fa-podcast" p-label="PO button"></po-button>

projects/ui/src/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form-field.interface.ts

@@ -114,7 +114,14 @@ export interface PoDynamicFormField extends PoDynamicField {
    * - Combo;
    * - Password;
    *
-   * > Veja a disponibilidade de ícones em [biblioteca de ícones](guides/icons).
+   * > **Deprecated v20.x.x.** Veja a disponibilidade de ícones em [biblioteca de ícones](guides/icons).
+   *
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    */
   icon?: string | TemplateRef<void>;
 

projects/ui/src/lib/components/po-dynamic/po-dynamic-view/po-dynamic-view-field.interface.ts

@@ -70,7 +70,14 @@ export interface PoDynamicViewField extends PoDynamicField {
   /**
    * Define um ícone que será exibido ao lado do valor para o campo do tipo *tag*.
    *
-   * > Veja os valores válidos na [biblioteca de ícones](guides/icons).
+   * > **Deprecated v20.x.x.** Veja os valores válidos na [biblioteca de ícones](guides/icons).
+   *
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    */
   icon?: string;
 

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

@@ -163,10 +163,16 @@ export abstract class PoComboBaseComponent implements ControlValueAccessor, OnIn
    *
    * Define o ícone que será exibido no início do campo.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-combo p-icon="po-icon-user" p-label="PO combo"></po-combo>
    * ```
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * <po-combo p-icon="fa fa-podcast" p-label="PO combo"></po-combo>

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

@@ -72,10 +72,16 @@ export abstract class PoInputBaseComponent implements ControlValueAccessor, Vali
    *
    * Define o ícone que será exibido no início do campo.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-input p-icon="po-icon-user" p-label="PO input"></po-input>
    * ```
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * <po-input p-icon="fa fa-podcast" p-label="PO input"></po-input>

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

@@ -26,10 +26,16 @@ export class PoIconComponent {
   /**
    * Define o ícone a ser exibido.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-button p-icon="po-icon-user" p-label="PO button"></po-button>
    * ```
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * <po-button p-icon="fa fa-podcast" p-label="PO button"></po-button>

projects/ui/src/lib/components/po-listbox/po-item-list/interfaces/po-item-list-action.interface.ts

@@ -22,13 +22,18 @@ export interface PoItemListAction {
    *
    * Define um ícone que será exibido ao lado esquerdo do rótulo.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-component
    *  [p-property]="[{ label: 'PO ICON', icon: 'po-icon-news' }]">
    * </po-component>
    * ```
-   *
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca Font Awesome, da seguinte forma:
    * ```
    * <po-component

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

@@ -33,13 +33,18 @@ export interface PoMenuItem {
   action?: Function;
 
   /**
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-menu
    *  [p-menus]="[{ link: '/', label: 'PO ICON', icon: 'po-icon-news' }]">
    * </po-menu>
    * ```
-   *
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca Font Awesome, da seguinte forma:
    * ```
    * <po-menu

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

@@ -130,10 +130,16 @@ export class PoModalBaseComponent {
    * @description
    * Ícone exibido ao lado esquerdo do label do titúlo da modal.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-modal p-icon="po-icon-user" p-title="PO Modal"></po-modal>
    * ```
+   *  Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * <po-modal p-icon="fa fa-podcast" p-title="PO Modal"></po-modal>

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

@@ -20,13 +20,18 @@ export interface PoNavbarIconAction {
   /**
    * Ícone exibido.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-navbar
    *   [p-icon-actions]="[{ link: '/', icon: 'po-icon-news' }]">
    * </po-navbar>
    * ```
-   *
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca Font Awesome, da seguinte forma:
    * ```
    * <po-navbar

projects/ui/src/lib/components/po-popup/po-popup-action.interface.ts

@@ -25,13 +25,18 @@ export interface PoPopupAction {
    *
    * Define um ícone que será exibido ao lado esquerdo do rótulo.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-component
    *  [p-property]="[{ label: 'PO ICON', icon: 'po-icon-news' }]">
    * </po-component>
    * ```
-   *
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-component
+   *  [p-property]="[{ label: 'ICON', icon: 'ph ph-user' }]">
+   * </po-component>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca Font Awesome, da seguinte forma:
    * ```
    * <po-component

projects/ui/src/lib/components/po-table/po-table-column-icon/po-table-column-icon.interface.ts

@@ -41,11 +41,14 @@ export interface PoTableColumnIcon {
   disabled?: Function;
 
   /**
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * [ { icon: 'po-icon-plus' } ]
    * ```
-   *
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * [{ icon: 'ph ph-user' }]
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca Font Awesome, da seguinte forma:
    * ```
    * [ {  icon: 'fas fa-plus' } ]

projects/ui/src/lib/components/po-table/po-table-column-label/po-table-column-label.interface.ts

@@ -75,10 +75,14 @@ export interface PoTableColumnLabel {
    * - <span class="po-icon po-icon-close"></span> - `danger`
    * - <span class="po-icon po-icon-info"></span> - `info`
    *
-   * Também É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** Também É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-tag p-icon="po-icon-user" p-value="PO Tag"></po-tag>
    * ```
+   *  Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-tag p-icon="ph ph-user" p-value="PO Tag"></po-button>
+   * ```
    * como também utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * <po-tag p-icon="fa fa-podcast" p-value="PO Tag"></po-button>

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

@@ -242,10 +242,14 @@ export class PoTagBaseComponent {
    * - <span class="po-icon po-icon-close"></span> - `danger`
    * - <span class="po-icon po-icon-info"></span> - `info`
    *
-   * Também É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** Também É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-tag p-icon="po-icon-user" p-value="PO Tag"></po-tag>
    * ```
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-tag p-icon="ph ph-user" p-value="PO Tag"></po-button>
+   * ```
    * como também utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * <po-tag p-icon="fa fa-podcast" p-value="PO Tag"></po-button>

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

@@ -28,10 +28,14 @@ export class PoToolbarBaseComponent {
    *
    * Define um [ícone](/guides/icons) para a propriedade `p-actions`.
    *
-   * É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
+   * **Deprecated v20.x.x.** É possível usar qualquer um dos ícones da [Biblioteca de ícones](/guides/icons). conforme exemplo abaixo:
    * ```
    * <po-toolbar p-actions-icon="po-icon-user" [p-actions]="actions"></po-toolbar>
    * ```
+   * Utilize os ícones disponíveis na Lib [Phosphor](/guides/icons), conforme exemplo:
+   * ```
+   * <po-tag p-icon="ph ph-user" p-value="PO Tag"></po-button>
+   * ```
    * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
    * ```
    * <po-toolbar p-actions-icon="far fa-comment-alt" [p-actions]="actions"></po-toolbar>