@po-ui/ng-components 19.6.0 → 19.7.0

package/lib/services/po-notification/po-notification-base.service.d.ts

@@ -1,6 +1,7 @@
 import { ComponentRef } from '@angular/core';
-import { PoNotification } from './po-notification.interface';
 import { PoToaster } from '../../components/po-toaster';
+import { PoThemeService } from '../po-theme';
+import { PoNotification } from './po-notification.interface';
 /**
  * @description
  *
@@ -23,9 +24,11 @@ import { PoToaster } from '../../components/po-toaster';
  *
  */
 export declare abstract class PoNotificationBaseService {
+    protected poThemeService: PoThemeService;
     stackTop: Array<ComponentRef<any>>;
     stackBottom: Array<ComponentRef<any>>;
     private defaultDuration;
+    constructor(poThemeService: PoThemeService);
     /**
      * Emite uma notificação de sucesso.
      *

package/lib/services/po-notification/po-notification.interface.d.ts

@@ -20,6 +20,17 @@ export interface PoNotification {
     actionLabel?: string;
     /** Mensagem a ser exibida na notificação. */
     message: string;
+    /**
+     * Define o tamanho das ações:
+     * - `small`: aplica a medida small de cada ação (disponível apenas para acessibilidade AA).
+     * - `medium`: aplica a medida medium de cada ação.
+     *
+     * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
+     * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
+     *
+     * @default `small`
+     */
+    sizeActions?: string;
     /** Mensagem de suporte a ser exibida na notificação. */
     supportMessage?: string;
     /**

package/lib/services/po-notification/po-notification.service.d.ts

@@ -1,6 +1,7 @@
+import { PoToaster } from '../../components/po-toaster';
+import { PoThemeService } from '../po-theme';
 import { PoComponentInjectorService } from './../po-component-injector/po-component-injector.service';
 import { PoNotificationBaseService } from './po-notification-base.service';
-import { PoToaster } from '../../components/po-toaster';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoNotificationBaseService
@@ -24,7 +25,8 @@ import * as i0 from "@angular/core";
  */
 export declare class PoNotificationService extends PoNotificationBaseService {
     private poComponentInjector;
-    constructor(poComponentInjector: PoComponentInjectorService);
+    protected poThemeService: PoThemeService;
+    constructor(poComponentInjector: PoComponentInjectorService, poThemeService: PoThemeService);
     createToaster(toaster: PoToaster): void;
     destroyToaster(toaster: any): void;
     private observableOnClose;

package/lib/services/po-theme/enum/po-theme-a11y.enum.d.ts

@@ -1,28 +1,32 @@
 /**
- * Enum para definir os níveis de acessibilidade suportados pelo serviço de temas.
- *
  * @usedBy PoThemeService
  *
- * @example
- *
- * Em um serviço de tema, você pode usar este enum de acessibilidade para alternar entre os níveis de temas suportados.
+ * @description
+ * Enum para configurar o nível de acessibilidade dos componentes através do serviço de tema.
  *
  * ```
  * import { PoThemeA11yEnum } from '@po-ui/theme';
  *
- * // Definindo o nível de acessibilidade ao setar o tema junto com o tipo
+ * // Definindo o nível de acessibilidade ao configurar as cores e o tipo do tema (light | dark)
  * themeService.setTheme(...theme, ...type, PoThemeA11yEnum.AA);
  *
- * // Definir o tema junto com o nível de acessibilidade
+ * // Definindo o nível de acessibilidade ao configurar apenas as cores do tema
  * themeService.setThemeA11y(...theme, PoThemeA11yEnum.AAA);
  *
- * // Definir o nível de acessibilidade de um tema já aplicado
+ * // Alterando o nível de acessibilidade com as cores do tema já definidas
  * themeService.setCurrentThemeA11y(PoThemeA11yEnum.AAA);
  * ```
  */
 export declare enum PoThemeA11yEnum {
-    /** Nível de acessibilidade duplo A (AA) */
+    /** Nível de acessibilidade AA.
+     * - Define a espessura do `outline` para **2px**.
+     * - Disponibiliza o tamanho `small` para componentes de formulário (buttons, inputs, checkboxes, radios e switches)
+     * conforme suas documentações.
+     */
     AA = "AA",
-    /** Nível de acessibilidade triplo A (AAA) */
+    /** Nível de acessibilidade AAA.
+     * - Define a espessura do `outline` para **4px**.
+     * - Não disponibiliza o tamanho `small` para componentes de formulário.
+     */
     AAA = "AAA"
 }

package/lib/services/po-theme/enum/po-theme-type.enum.d.ts

@@ -1,22 +1,19 @@
 /**
- * Enum para definir os tipos de tema suportados pelo serviço de temas.
- *
  * @usedBy PoThemeService
  *
- * @example
- *
- * Em um serviço de tema, você pode usar este enum para alternar entre os tipos de temas suportados.
+ * @description
+ * Enum utilizado para configurar o tipo de tema suportado, é possível alternar entre os tipos definidos.
  *
  * ```
  * import { PoThemeTypeEnum } from '@po-ui/theme';
  *
- * // Definindo o tipo de tema para light
+ * // Definindo o tipo de tema como claro
  * themeService.setTheme(...theme, PoThemeTypeEnum.light);
  *
- * // Definindo o tipo de tema para dark
+ * // Definindo o tipo de tema como escuro
  * themeService.setTheme(...theme, PoThemeTypeEnum.dark);
  *
- * // Definir o tipo do tema de um tema já aplicado
+ * // Alterando o tipo do tema para um tema já aplicado
  * themeService.setCurrentThemeType(PoThemeTypeEnum.dark);
  * ```
  */

package/lib/services/po-theme/interfaces/po-theme.interface.d.ts

@@ -8,34 +8,43 @@ import { PoThemeTokens } from './po-theme-tokens.interface';
  * Interface para o método `setTheme()`.
  */
 export interface PoTheme {
-    /** Nome do tema: 'default', 'totvs', 'sunset', etc. */
+    /** Nome para o tema:
+     * Ex.: default, totvs, sunset... */
     name: string;
-    /** Tipos de tema: 'light' e 'dark' */
+    /** Tipo de tema:
+     * - light
+     * - dark */
     type: PoThemeType | Array<PoThemeType>;
-    /** Tipo e nivel de acessibilidade de tema ativo */
+    /** Tipo e nível de acessibilidade de tema ativo */
     active?: PoThemeTypeEnum | PoThemeActive;
 }
 /**
  * @docsPrivate
  * @description
- * Interface para os tipos de tema ('light' e 'dark').
+ * Interface para os tipos de tema ('light' | 'dark').
  */
 export interface PoThemeType {
-    /** Tipo de tipo 'light' */
+    /** Tema claro */
     light?: PoThemeTokens;
-    /** Tipo de tipo 'dark' */
+    /** Tema escuro */
     dark?: PoThemeTokens;
-    /** Nivel de Acessibilidade */
+    /** Nível de acessibilidade dos componentes:
+     * - AA
+     * - AAA */
     a11y?: PoThemeA11yEnum;
 }
 /**
  * @docsPrivate
  * @description
- * Interface para o tipo de tema ativo.
+ * Interface para o tema ativo.
  */
 export interface PoThemeActive {
-    /** Tipo de tema ativo */
+    /** Tipo de tema:
+     * - light
+     * - dark */
     type?: PoThemeTypeEnum;
-    /** Nivel de Acessibilidade */
+    /** Nível de acessibilidade dos componentes:
+     * - AA
+     * - AAA */
     a11y?: PoThemeA11yEnum;
 }

package/lib/services/po-theme/po-theme.service.d.ts

@@ -1,7 +1,7 @@
 import { RendererFactory2 } from '@angular/core';
-import { PoTheme, PoThemeActive } from './interfaces/po-theme.interface';
 import { PoThemeA11yEnum } from './enum/po-theme-a11y.enum';
 import { PoThemeTypeEnum } from './enum/po-theme-type.enum';
+import { PoTheme, PoThemeActive } from './interfaces/po-theme.interface';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -38,10 +38,31 @@ export declare class PoThemeService {
      *
      * @param {PoTheme} themeConfig - Configuração de tema a ser aplicada ao componente.
      * @param {PoThemeTypeEnum} [themeType=PoThemeTypeEnum.light] - (Opcional) Tipo de tema, podendo ser 'light' (claro) ou 'dark' (escuro). O tema claro é o padrão.
-     * @param {PoThemeA11yEnum} [a11yLevel=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade do tema, podendo ser AA ou AAA. Padrão é AAA.
+     * @param {PoThemeA11yEnum} [a11yLevel=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade dos componentes, podendo ser AA ou AAA. Padrão é AAA.
      * @param {boolean} [persistPreference=true] - (Opcional) Define se a preferência de tema deve ser salva no localStorage para persistência. `true` para salvar, `false` para não salvar.
      */
     setTheme(themeConfig: PoTheme, themeType?: PoThemeTypeEnum, a11yLevel?: PoThemeA11yEnum, persistPreference?: boolean): void;
+    /**
+     * Retorna o nível de acessibilidade configurado no tema.
+     * Se não estiver configurado, retorna `AAA` como padrão.
+     * @returns {PoThemeA11yEnum} O nível de acessibilidade, que pode ser `AA` ou `AAA`.
+     */
+    getA11yLevel(): PoThemeA11yEnum;
+    /**
+     * Define o tamanho `small` como padrão para componentes de formulário que não possuem um tamanho definido.
+     * Essa configuração é aplicada globalmente apenas quando o nível de acessibilidade for `AA`.
+     * Caso contrário, o tamanho padrão será `medium`.
+     *
+     * @param {boolean} enable Habilita ou desabilita o tamanho `small` globalmente.
+     */
+    setA11yDefaultSizeSmall(enable: boolean): boolean;
+    /**
+     * @docsPrivate
+     * Retorna a preferência global de tamanho dos componentes.
+     *
+     * @returns `'small'` ou `'medium'`.
+     */
+    getA11yDefaultSize(): string;
     /**
      * @docsPrivate
      *
@@ -137,7 +158,8 @@ export declare class PoThemeService {
      */
     private setThemeLocal;
     /**
-     * Retorna o tema ativo como um observable.
+     * Retorna o tema ativo como um observable. Este método funcionará apenas se o tema estiver armazenado no `localStorage`.
+     *
      * @returns {PoTheme} Tema ativo.
      */
     getThemeActive(): PoTheme;
@@ -204,18 +226,22 @@ export declare class PoThemeService {
      */
     setCurrentThemeType(themeType?: PoThemeTypeEnum): void;
     /**
-     * Define o nivel de acessibilidade quando um tema está sendo aplicado.
+     * Define o nível de acessibilidade quando um tema está sendo aplicado.
      *
      * @param {PoTheme} theme - Objeto contendo as definições de tema a serem aplicadas no componente.
-     * @param {PoThemeA11yEnum} [a11y=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade a ser aplicado ao tema, como AA ou AAA. Se não for informado, por padrão a acessibilidade será AAA.
+     * @param {PoThemeA11yEnum} [a11y=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade dos componentes podendo ser
+     * AA ou AAA. Por padrão a acessibilidade é AAA.
      */
     setThemeA11y(theme: PoTheme, a11y?: PoThemeA11yEnum): void;
     /**
-     * Define o nivel de acessibilidade para um tema já ativo.
+     * Define o nível de acessibilidade para um tema já ativo.
      *
-     * @param {PoThemeA11yEnum} [a11y=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade a ser aplicado ao tema, como AA ou AAA. Se não for informado, por padrão a acessibilidade será AAA.
+     * @param {PoThemeA11yEnum} [a11y=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade dos componentes podendo ser
+     * AA ou AAA. Por padrão a acessibilidade é AAA.
      */
     setCurrentThemeA11y(a11y?: PoThemeA11yEnum): void;
+    resetBaseTheme(): void;
+    private setDefaultBaseStyle;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoThemeService, [null, null, { optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<PoThemeService>;
 }

package/lib/utils/util.d.ts

@@ -1,3 +1,4 @@
+import { PoThemeService } from '../services';
 /**
  * Converte e formata os bytes em formato mais legível para o usuário.
  *
@@ -14,6 +15,10 @@ export declare function formatBytes(bytes: number, decimals?: number): string;
  * Retorna o idioma atual do navegador
  */
 export declare function getBrowserLanguage(): string;
+/**
+ * Retorna o tamanho padrão dos componentes conforme o nível de acessibilidade.
+ */
+export declare function getDefaultSize<T>(poThemeService: PoThemeService, sizeEnum: T): T[keyof T];
 /**
  * Retorna o idioma do navegador, com somente as duas primeiras letras. Por exemplo: "pt" ou "es".
  *
@@ -238,3 +243,7 @@ export declare function replaceFormatSeparator(format: string, separator: string
  * @param isAscendingOrder : ordenação crescente ou descrescente.
  */
 export declare function sortArrayOfObjects(items: any, key: any, isAscendingOrder: any): any;
+/**
+ * Valida e retorna um tamanho permitido para os componentes, considerando a acessibilidade.
+ */
+export declare function validateSize<T>(value: string, poThemeService: PoThemeService, sizeEnum: T): T[keyof T];

package/package.json

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

package/lib/components/po-button/po-button-kind.enum.d.ts

@@ -1,5 +0,0 @@
-export declare enum PoButtonKind {
-    primary = "primary",
-    secondary = "secondary",
-    tertiary = "tertiary"
-}

package/lib/components/po-button/po-button-size.enum.d.ts

@@ -1,4 +0,0 @@
-export declare enum PoButtonSize {
-    medium = "medium",
-    large = "large"
-}

package/lib/components/po-field/po-checkbox/po-checkbox-size.enum.d.ts

@@ -1,13 +0,0 @@
-/**
- * @usedBy PoCheckboxComponent
- *
- * @description
- *
- * Enum para definir o tamanho do po-checkbox.
- */
-export declare enum PoCheckboxSize {
-    /** A caixa de seleção fica do tamanho padrão, com 24px de altura. */
-    medium = "medium",
-    /** A caixa de seleção fica maior, com 32px de altura. */
-    large = "large"
-}

package/lib/components/po-field/po-radio/po-radio-size.enum.d.ts

@@ -1,11 +0,0 @@
-/**
- * @usedBy PoRadioComponent
- *
- * @description
- *
- * Enum para definir o tamanho do po-radio.
- */
-export declare enum PoRadioSize {
-    Medium = "medium",
-    Large = "large"
-}