@po-ui/ng-components 19.29.0 → 19.30.0

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

@@ -0,0 +1,52 @@
+import { ElementRef, AfterViewInit, OnDestroy, OnChanges, SimpleChanges, ChangeDetectorRef } from '@angular/core';
+import { PoHelperBaseComponent } from './po-helper-base.component';
+import { PoPopoverComponent } from '../po-popover/po-popover.component';
+import { PoButtonComponent } from '../po-button';
+import * as i0 from "@angular/core";
+/**
+ * @docsExtends PoHelperBaseComponent
+ *
+ * @example
+ *
+ * <example name="po-helper-basic" title="PO Helper Basic">
+ *  <file name="sample-po-helper-basic/sample-po-helper-basic.component.html"> </file>
+ *  <file name="sample-po-helper-basic/sample-po-helper-basic.component.ts"> </file>
+ * </example>
+ *
+ * <example name="po-helper-labs" title="PO Helper Labs">
+ *  <file name="sample-po-helper-labs/sample-po-helper-labs.component.html"> </file>
+ *  <file name="sample-po-helper-labs/sample-po-helper-labs.component.ts"> </file>
+ * </example>
+ *
+ * <example name="po-helper-sales-performance" title="PO Helper Sales Performance">
+ *  <file name="sample-po-helper-sales-performance/sample-po-helper-sales-performance.component.html"> </file>
+ *  <file name="sample-po-helper-sales-performance/sample-po-helper-sales-performance.component.ts"> </file>
+ * </example>
+ *
+ */
+export declare class PoHelperComponent extends PoHelperBaseComponent implements AfterViewInit, OnDestroy, OnChanges {
+    private readonly cdr;
+    target: ElementRef;
+    popover: PoPopoverComponent;
+    poButton: PoButtonComponent;
+    private static instances;
+    private static idCounter;
+    protected popoverPosition: string;
+    id: string;
+    private boundFocusIn;
+    private readonly poHelperLiterals;
+    constructor(cdr: ChangeDetectorRef);
+    ngAfterViewInit(): void;
+    setPopoverPositionByScreen(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    openHelperPopover(): void;
+    closeHelperPopover(): void;
+    emitClick(event: MouseEvent): void;
+    onKeyDown(event: KeyboardEvent): void;
+    private handleEmitEvent;
+    closePopoverOnFocusOut(event: FocusEvent): void;
+    protected ariaLabel(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PoHelperComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoHelperComponent, "po-helper", never, {}, {}, never, never, false, never>;
+}

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

@@ -0,0 +1,16 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./po-helper.component";
+import * as i2 from "@angular/common";
+import * as i3 from "../po-icon/po-icon.module";
+import * as i4 from "../po-popover/po-popover.module";
+import * as i5 from "../po-link/po-link.module";
+import * as i6 from "../po-divider/po-divider.module";
+/**
+ * @description
+ * Módulo do componente po-helper
+ */
+export declare class PoHelperModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<PoHelperModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoHelperModule, [typeof i1.PoHelperComponent], [typeof i2.CommonModule, typeof i3.PoIconModule, typeof i4.PoPopoverModule, typeof i5.PoLinkModule, typeof i6.PoDividerModule], [typeof i1.PoHelperComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<PoHelperModule>;
+}

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

@@ -35,6 +35,19 @@ export declare class PoLabelComponent {
     label?: string;
     /** Indica o tipo do campo vinculado ao label */
     requirement?: string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Habilita a quebra automática do texto. Quando ativada, o texto que excede
+     * o espaço disponível é transferido para a próxima linha em pontos apropriados para uma
+     * leitura clara.
+     *
+     * @default `false`
+     */
+    textWrap: import("@angular/core").InputSignal<boolean>;
+    isRequiredLiteral(value: string): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoLabelComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PoLabelComponent, "po-label", never, { "disabled": { "alias": "p-disabled"; "required": false; }; "field": { "alias": "p-field"; "required": false; }; "for": { "alias": "p-for"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "requirement": { "alias": "p-requirement"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoLabelComponent, "po-label", never, { "disabled": { "alias": "p-disabled"; "required": false; }; "field": { "alias": "p-field"; "required": false; }; "for": { "alias": "p-for"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "requirement": { "alias": "p-requirement"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; "isSignal": true; }; }, {}, never, never, false, never>;
 }

package/lib/components/po-label/po-label.module.d.ts

@@ -1,8 +1,9 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./po-label.component";
 import * as i2 from "@angular/common";
+import * as i3 from "../po-helper/po-helper.module";
 export declare class PoLabelModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoLabelModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoLabelModule, [typeof i1.PoLabelComponent], [typeof i2.CommonModule], [typeof i1.PoLabelComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoLabelModule, [typeof i1.PoLabelComponent], [typeof i2.CommonModule, typeof i3.PoHelperModule], [typeof i1.PoLabelComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoLabelModule>;
 }

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

@@ -1,4 +1,4 @@
-import { AfterViewInit, ElementRef, OnChanges, OnDestroy, Renderer2, SimpleChanges } from '@angular/core';
+import { AfterViewInit, ChangeDetectorRef, ElementRef, OnChanges, OnDestroy, Renderer2, SimpleChanges } from '@angular/core';
 import { PoControlPositionService } from './../../services/po-control-position/po-control-position.service';
 import { PoPopoverBaseComponent } from './po-popover-base.component';
 import * as i0 from "@angular/core";
@@ -25,14 +25,15 @@ import * as i0 from "@angular/core";
  */
 export declare class PoPopoverComponent extends PoPopoverBaseComponent implements AfterViewInit, OnDestroy, OnChanges {
     private renderer;
-    private poControlPosition;
+    private readonly poControlPosition;
+    private readonly cd;
     popoverElement: ElementRef;
     arrowDirection: string;
     timeoutResize: any;
     targetElement: any;
     afterViewInitWasCalled: boolean;
     eventListenerFunction: () => void;
-    constructor(renderer: Renderer2, poControlPosition: PoControlPositionService);
+    constructor(renderer: Renderer2, poControlPosition: PoControlPositionService, cd: ChangeDetectorRef);
     ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
     initEvents(): void;
@@ -40,6 +41,7 @@ export declare class PoPopoverComponent extends PoPopoverBaseComponent implement
     close(): void;
     debounceResize(): void;
     open(): void;
+    ensurePopoverPosition(): void;
     setOpacity(value: number): void;
     setPopoverPosition(): void;
     setRendererListenInit(): void;

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

@@ -42,6 +42,7 @@ export declare class PoThemeService {
      * @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;
+    private setDataDefaultSizeHTML;
     /**
      * Retorna o nível de acessibilidade configurado no tema.
      * Se não estiver configurado, retorna `AAA` como padrão.

package/lib/utils/util.d.ts

@@ -1,5 +1,6 @@
 import { PoThemeService } from '../services/po-theme/po-theme.service';
 import { PoThemeA11yEnum } from '../services/po-theme/enum/po-theme-a11y.enum';
+import { ElementRef } from '@angular/core';
 /**
  * Converte e formata os bytes em formato mais legível para o usuário.
  *
@@ -272,3 +273,25 @@ export declare function getA11yDefaultSize(): string;
  * @returns {PoThemeA11yEnum} O nível de acessibilidade, que pode ser `AA` ou `AAA`.
  */
 export declare function getA11yLevel(): PoThemeA11yEnum;
+/**
+ * Realiza a tradução das propriedades de ajuda dos componentes.
+ * Type do Helper default é 'help' e size 'medium'.
+ * @returns Objeto {helperSettings} com as propriedades do helper
+ * @returns Propriedade {hideAdditionalHelp} para controle ao esconder o ícone de ajuda adicional depreciado.
+ */
+export declare function setHelperSettings(label: string, additionalHelpTooltip: string, poHelperComponent?: any, size?: string, onClick?: any): {
+    hideAdditionalHelp: boolean;
+    helperSettings?: any;
+};
+/** Atualiza o estado do tooltip baseado na propriedade scrollWidth e clientWidth do labelElement.
+ * @param isTooltipActive Indica se o tooltip já está ativo
+ * @param labelElement ElementRef do label que será verificado se está com ellipsis
+ * @returns boolean indicando se o tooltip deve ser ativado ou desativado
+ */
+export declare function updateTooltip(isTooltipActive: boolean, labelElement: ElementRef<HTMLElement>): boolean;
+/**
+ * Retorna o elemento label que deve ser medido para verificar se está com ellipsis.
+ * @param labelElement ElementRef do label que será verificado se está com ellipsis
+ * @returns O elemento que deve ser medido para verificar se está com ellipsis.
+ */
+export declare function getMeasurableEl(labelElement: ElementRef<HTMLElement>): Element;

package/package.json

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