@po-ui/ng-components 19.0.0 → 19.2.0

package/lib/components/po-field/po-textarea/po-textarea.component.d.ts

@@ -34,6 +34,7 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
     valueBeforeChange: any;
     fireChange: boolean;
     constructor(cd: ChangeDetectorRef, el: ElementRef);
+    emitAdditionalHelp(): void;
     /**
      * Função que atribui foco ao componente.
      *
@@ -53,6 +54,7 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
      */
     focus(): void;
     ngAfterViewInit(): void;
+    getAdditionalHelpTooltip(): string;
     getErrorPattern(): string;
     hasInvalidClass(): boolean;
     writeValueModel(value: any): void;
@@ -61,6 +63,8 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
     eventOnFocus(): void;
     eventOnBlur(): void;
     controlChangeEmitter(): void;
+    showAdditionalHelpIcon(): boolean;
+    private isAdditionalHelpEventTriggered;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoTextareaComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoTextareaComponent, "po-textarea", never, {}, {}, never, never, false, never>;
 }

package/lib/components/po-field/po-upload/po-upload-base.component.d.ts

@@ -29,6 +29,31 @@ export declare const poUploadLiteralsDefault: {
  */
 export declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Validator {
     protected uploadService: PoUploadService;
+    additionalHelpEventTrigger: string | undefined;
+    /**
+     * @optional
+     *
+     * @description
+     * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
+     * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
+     * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
+     * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
+     */
+    additionalHelpTooltip?: string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define que o tooltip (`p-additional-help-tooltip`) será incluído no body da página e não dentro do componente. Essa
+     * opção pode ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o
+     * posicionamento correto do tooltip próximo ao elemento.
+     *
+     * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
+     *
+     * @default `false`
+     */
+    appendBox?: boolean;
     /**
      * @optional
      *
@@ -117,6 +142,14 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
      * @default `true`
      */
     requiredUrl: boolean;
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado ao clicar no ícone de ajuda adicional.
+     * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
+     */
+    additionalHelp: EventEmitter<any>;
     /**
      * @optional
      *
@@ -453,7 +486,8 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
     abstract sendFeedback(): void;
     abstract setDirectoryAttribute(value: boolean): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoUploadBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoUploadBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "dragDropHeight": { "alias": "p-drag-drop-height"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "name": { "alias": "name"; "required": false; }; "autoUpload": { "alias": "p-auto-upload"; "required": false; }; "disabledRemoveFile": { "alias": "p-disabled-remove-file"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "headers": { "alias": "p-headers"; "required": false; }; "requiredUrl": { "alias": "p-required-url"; "required": false; }; "customAction": { "alias": "p-custom-action"; "required": false; }; "directory": { "alias": "p-directory"; "required": false; }; "dragDrop": { "alias": "p-drag-drop"; "required": false; }; "hideRestrictionsInfo": { "alias": "p-hide-restrictions-info"; "required": false; }; "hideSelectButton": { "alias": "p-hide-select-button"; "required": false; }; "hideSendButton": { "alias": "p-hide-send-button"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "fileRestrictions": { "alias": "p-restrictions"; "required": false; }; "formField": { "alias": "p-form-field"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "isMultiple": { "alias": "p-multiple"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "customActionClick": "p-custom-action-click"; "onUpload": "p-upload"; "onError": "p-error"; "onSuccess": "p-success"; "ngModelChange": "ngModelChange"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoUploadBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "dragDropHeight": { "alias": "p-drag-drop-height"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "name": { "alias": "name"; "required": false; }; "autoUpload": { "alias": "p-auto-upload"; "required": false; }; "disabledRemoveFile": { "alias": "p-disabled-remove-file"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "headers": { "alias": "p-headers"; "required": false; }; "requiredUrl": { "alias": "p-required-url"; "required": false; }; "customAction": { "alias": "p-custom-action"; "required": false; }; "directory": { "alias": "p-directory"; "required": false; }; "dragDrop": { "alias": "p-drag-drop"; "required": false; }; "hideRestrictionsInfo": { "alias": "p-hide-restrictions-info"; "required": false; }; "hideSelectButton": { "alias": "p-hide-select-button"; "required": false; }; "hideSendButton": { "alias": "p-hide-send-button"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "fileRestrictions": { "alias": "p-restrictions"; "required": false; }; "formField": { "alias": "p-form-field"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "isMultiple": { "alias": "p-multiple"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "customActionClick": "p-custom-action-click"; "onUpload": "p-upload"; "onError": "p-error"; "onSuccess": "p-success"; "ngModelChange": "ngModelChange"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_disabledRemoveFile: any;
     static ngAcceptInputType_requiredUrl: any;

package/lib/components/po-field/po-upload/po-upload.component.d.ts

@@ -71,6 +71,7 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
     ngAfterViewInit(): void;
     /** Método responsável por **limpar** o(s) arquivo(s) selecionado(s). */
     clear(): void;
+    emitAdditionalHelp(): void;
     /**
      * Função que atribui foco ao componente.
      *
@@ -89,6 +90,7 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
      * ```
      */
     focus(): void;
+    getAdditionalHelpTooltip(): string;
     hasAnyFileUploading(files: Array<PoUploadFile>): boolean;
     isAllowCancelEvent(status: PoUploadStatus): status is PoUploadStatus.Uploading | PoUploadStatus.Error | PoUploadStatus.None;
     onFileChange(event: any): void;
@@ -100,11 +102,13 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
     /** Método responsável por **enviar** o(s) arquivo(s) selecionado(s). */
     sendFiles(): void;
     setDirectoryAttribute(canHandleDirectory: boolean): void;
+    showAdditionalHelpIcon(): boolean;
     stopUpload(file: PoUploadFile): void;
     trackByFn(index: any, file: PoUploadFile): string;
     uploadFiles(files: Array<PoUploadFile>): void;
     customClick(file: PoUploadFile): void;
     private cleanInputValue;
+    private isAdditionalHelpEventTriggered;
     private responseHandler;
     private setPipeArguments;
     private stopUploadHandler;

package/lib/components/po-listbox/po-item-list/po-item-list.component.d.ts

@@ -10,6 +10,7 @@ export declare class PoItemListComponent extends PoItemListBaseComponent impleme
     protected param: any;
     protected clickListener: () => void;
     constructor(sanitized: DomSanitizer);
+    private shouldUpdateSelected;
     ngOnChanges(changes: SimpleChanges): void;
     onCheckboxItem(): void;
     onComboItem(options: any, event: any): void;

package/lib/components/po-modal/po-modal-base.component.d.ts

@@ -71,7 +71,6 @@ export declare class PoModalBaseComponent {
      * > Quando informado `auto` a modal calculará automaticamente seu tamanho baseado em seu conteúdo.
      * Caso não seja informado um valor, a modal terá o tamanho definido como `md`.
      *
-     * > Todas as opções de tamanho possuem uma largura máxima de **768px**.
      */
     set size(value: string);
     get size(): string;

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

@@ -20,6 +20,18 @@ import * as i0 from "@angular/core";
  *
  */
 export declare class PoPopoverBaseComponent {
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define que o popover será inserido no body da página em vez do elemento definido em `p-target`. Essa opção pode
+     * ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o posicionamento
+     * correto do conteúdo próximo ao elemento.
+     *
+     * @default `false`
+     */
+    appendBox: boolean;
     /**
      * @description
      *
@@ -130,5 +142,6 @@ export declare class PoPopoverBaseComponent {
     set trigger(value: string);
     get trigger(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPopoverBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoPopoverBaseComponent, never, never, { "target": { "alias": "p-target"; "required": false; }; "title": { "alias": "p-title"; "required": false; }; "hideArrow": { "alias": "p-hide-arrow"; "required": false; }; "position": { "alias": "p-position"; "required": false; }; "trigger": { "alias": "p-trigger"; "required": false; }; }, { "closePopover": "p-close"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoPopoverBaseComponent, never, never, { "appendBox": { "alias": "p-append-in-body"; "required": false; }; "target": { "alias": "p-target"; "required": false; }; "title": { "alias": "p-title"; "required": false; }; "hideArrow": { "alias": "p-hide-arrow"; "required": false; }; "position": { "alias": "p-position"; "required": false; }; "trigger": { "alias": "p-trigger"; "required": false; }; }, { "closePopover": "p-close"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
 }

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

@@ -1,12 +1,13 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./po-popover.component";
 import * as i2 from "@angular/common";
+import * as i3 from "@angular/cdk/overlay";
 /**
  * @description
  * Módulo do componente po-popover.
  */
 export declare class PoPopoverModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPopoverModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoPopoverModule, [typeof i1.PoPopoverComponent], [typeof i2.CommonModule], [typeof i1.PoPopoverComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoPopoverModule, [typeof i1.PoPopoverComponent], [typeof i2.CommonModule, typeof i3.OverlayModule], [typeof i1.PoPopoverComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoPopoverModule>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@po-ui/ng-components",
-  "version": "19.0.0",
+  "version": "19.2.0",
   "description": "PO UI - Components",
   "author": "PO UI",
   "license": "MIT",
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "@angular/cdk": "~19.0.3",
-    "@po-ui/style": "19.0.0",
-    "@po-ui/ng-schematics": "19.0.0",
+    "@po-ui/style": "19.2.0",
+    "@po-ui/ng-schematics": "19.2.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.0.0",
+    "@po-ui/style": "19.2.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.0.0');
+        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '19.2.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.0.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.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.0.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.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.0.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.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.0.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.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.0.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('19.0.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('19.2.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.0.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('19.0.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('19.2.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.0.0', changes_1.dependeciesChanges),
+        updatePackageJson('19.2.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.0.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.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.0.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.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.0.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.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.0.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.2.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {