@po-ui/ng-components 21.21.0 → 21.23.0

package/lib/components/po-field/po-search-ai/po-search-ai.component.d.ts

@@ -0,0 +1,58 @@
+import { ElementRef, OnChanges, SimpleChanges } from '@angular/core';
+import { PoButtonComponent } from '../../po-button/po-button.component';
+import { PoSearchAiBaseComponent } from './po-search-ai-base.component';
+/**
+ * @docsExtends PoSearchAiBaseComponent
+ *
+ * @example
+ *
+ * <example name="po-search-ai-basic" title="PO AI Search Basic">
+ *  <file name="sample-po-search-ai-basic/sample-po-search-ai-basic.component.html"> </file>
+ *  <file name="sample-po-search-ai-basic/sample-po-search-ai-basic.component.ts"> </file>
+ * </example>
+ *
+ * <example name="po-search-ai-labs" title="PO AI Search Labs">
+ *  <file name="sample-po-search-ai-labs/sample-po-search-ai-labs.component.html"> </file>
+ *  <file name="sample-po-search-ai-labs/sample-po-search-ai-labs.component.ts"> </file>
+ * </example>
+ *
+ * <example name="po-search-ai-result" title="PO AI Search - Result">
+ *  <file name="sample-po-search-ai-result/sample-po-search-ai-result.component.html"> </file>
+ *  <file name="sample-po-search-ai-result/sample-po-search-ai-result.component.ts"> </file>
+ * </example>
+ *
+ * <example name="po-search-ai-filter" title="PO AI Search - Filter">
+ *  <file name="sample-po-search-ai-filter/sample-po-search-ai-filter.component.html"> </file>
+ *  <file name="sample-po-search-ai-filter/sample-po-search-ai-filter.component.ts"> </file>
+ * </example>
+ */
+export declare class PoSearchAiComponent extends PoSearchAiBaseComponent implements OnChanges {
+    inp: ElementRef;
+    iconSearchAiEl: PoButtonComponent;
+    id: string;
+    constructor();
+    ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * Envia a consulta atual (valor do campo) para o endpoint de IA configurado em `p-url`.
+     *
+     * Caso a consulta esteja vazia ou `p-url` não esteja definido, nada é feito.
+     * O resultado é emitido via `p-result` (ou `p-low-confidence` quando a confiança for baixa)
+     * e falhas são emitidas via `p-error`.
+     */
+    search(): void;
+    clearAndFocus(): void;
+    handleCleanKeydown(event: KeyboardEvent): void;
+    /**
+     * Limpa o filtro aplicado via IA, esvazia o campo e emite o evento `p-clear`.
+     */
+    clearSearch(): void;
+    /**
+     * Manipula a tecla pressionada no campo: dispara a busca ao pressionar `Enter`.
+     *
+     * @param event Evento de teclado.
+     */
+    onSearchKeydown(event: KeyboardEvent): void;
+    private finishProcessing;
+    private handleResponse;
+    private handleError;
+}

package/lib/components/po-field/po-search-ai/po-search-ai.module.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @description
+ * Módulo do componente `po-search-ai`.
+ *
+ * Pode ser importado de forma independente por qualquer módulo que precise renderizar
+ * o campo de busca por IA.
+ */
+export declare class PoSearchAiModule {
+}

package/lib/components/po-field/po-search-ai/po-search-ai.service.d.ts

@@ -0,0 +1,34 @@
+import { HttpClient, HttpHeaders } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { PoSearchAiColumn, PoSearchAiColumnInput } from './interfaces/po-search-ai-column.interface';
+import { PoSearchAiResponse } from './interfaces/po-search-ai.interface';
+/**
+ * @docsPrivate
+ *
+ * Serviço responsável por enviar a consulta em linguagem natural para o endpoint de IA
+ * configurado no `PoSearchAiComponent` e tratar a resposta/erros.
+ *
+ * O serviço é agnóstico ao provedor de IA: ele apenas faz o `POST` do payload
+ * (`{ query, columns }`) e padroniza o tratamento de timeout e falhas.
+ */
+export declare class PoSearchAiService {
+    private readonly http;
+    readonly headers: HttpHeaders;
+    constructor(http: HttpClient);
+    /**
+     * Envia a consulta para o endpoint de IA.
+     *
+     * @param url Endpoint configurado em `p-url`.
+     * @param query Texto em linguagem natural digitado pelo usuário.
+     * @param columns Metadados das colunas/campos disponíveis para a busca.
+     * @param timeoutMs Tempo máximo de espera (ms) antes de abortar a requisição.
+     */
+    sendQuery(url: string, query: string, columns: Array<PoSearchAiColumn>, timeoutMs?: number): Observable<PoSearchAiResponse>;
+    /**
+     * Extrai e normaliza os metadados das colunas para envio à IA,
+     * descartando colunas sem `property` ou marcadas para serem ignoradas.
+     *
+     * @param columns Lista de colunas no formato bruto do componente consumidor.
+     */
+    extractColumnsMetadata(columns: Array<PoSearchAiColumnInput>): Array<PoSearchAiColumn>;
+}

package/lib/components/po-table/index.d.ts

@@ -6,6 +6,7 @@ export * from './interfaces/po-table-boolean.interface';
 export * from './interfaces/po-table-column.interface';
 export * from './interfaces/po-table-column-sort.interface';
 export * from './interfaces/po-table-literals.interface';
+export * from './interfaces/po-table-search-ai-field.interface';
 export * from './po-table-column-icon/po-table-column-icon.interface';
 export * from './po-table-column-label/po-table-column-label.interface';
 export * from './po-table-detail/po-table-detail-column.interface';

package/lib/components/po-table/interfaces/po-table-column.interface.d.ts

@@ -106,6 +106,7 @@ export interface PoTableColumn {
      * |------------|-----------------|-----------|----------|
      * | Monetário  | `currency`      | Formato para valores monetários. Informe o código da moeda (ISO 4217). | `'BRL'`, `'USD'`, `'EUR'`, `'RUB'` |
      * | Data       | `date`          | Aceita apenas os caracteres de dia(dd), mês(MM) e ano (yyyy ou yy), caso não seja informado um formato o mesmo será 'dd/MM/yyyy' | `'dd/MM/yyyy'`, `'dd-MM-yy'`, `'mm/dd/yyyy'` |
+     * | Data/Hora  | `dateTime`      | Aceita os caracteres de dia(dd), mês(MM), ano(yyyy), hora(HH para 24h ou hh para 12h), minutos(mm), segundos(ss), milissegundos(SSS) e período(a para AM/PM). Caso não seja informado um formato o mesmo será 'dd/MM/yyyy HH:mm:ss' | `'dd/MM/yyyy HH:mm'`, `'dd/MM/yyyy HH:mm:ss'`, `'dd/MM/yyyy HH:mm:ss.SSS'`, `'MM/dd/yyyy hh:mm a'`, `'yyyy-MM-dd HH:mm'`, `'short'`, `'medium'` |
      * | Hora       | `time`          | Aceita apenas os caracteres de hora(HH), minutos(mm), segundos(ss) e milisegundos(f-ffffff), os milisegundos são opcionais, caso não seja informado um formato o mesmo será 'HH:mm:ss' | `'HH:mm'`, `'HH:mm:ss.ffffff'`, `'HH:mm:ss.ff'`, `'mm:ss.fff'` |
      * | Número     | `number`        | Aceita um valor seguindo o padrão [**DecimalPipe**](https://angular.dev/api/common/DecimalPipe) para formatação, e caso não seja informado, o número será exibido na sua forma original. | `'1.2-5'` (ex.: `50` → `50.00`) |
      *
@@ -214,8 +215,10 @@ export interface PoTableColumn {
      *   por exemplo: `'2017-11-28'` ou `new Date(2017, 10, 28)`.
      *
      * - `dateTime`: valor de data com horário.
-     *   + Aceita o tipo _string_ no formato **ISO-8601** extendido **'yyyy-mm-ddThh:mm:ss+|-hh:mm'**
-     *   e o tipo _Date_ padrão do Javascript, por exemplo: `'2017-11-28T00:00:00-02:00'` ou `new Date(2017, 10, 28)`.
+     *   + Aceita o tipo _string_ no formato **ISO-8601** extendido **'yyyy-mm-ddTHH:mm:ss+|-hh:mm'**
+     *   ou **'yyyy-mm-ddTHH:mm+|-hh:mm'** (sem segundos),
+     *   e o tipo _Date_ padrão do Javascript, por exemplo: `'2017-11-28T00:00:00-02:00'`, `'2017-11-28T14:30-02:00'` ou `new Date(2017, 10, 28)`.
+     *   + A formatação de exibição pode ser configurada pela propriedade `format`.
      *
      * - `detail`: array de objetos para o master-detail.
      *   + Incompatível com `virtual-scroll`, que requer altura fixa nas linhas.
@@ -260,4 +263,54 @@ export interface PoTableColumn {
      */
     width?: string;
     fixed?: boolean;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define uma máscara para formatação do valor exibido na coluna.
+     *
+     * A máscara é aplicada somente para **exibição** na tabela, formatando o valor bruto
+     * armazenado no model antes de apresentá-lo ao usuário.
+     *
+     * Caracteres válidos para a máscara:
+     * - `9` : aceita um dígito numérico (0-9).
+     * - `@` : aceita um caractere alfabético (a-z, A-Z).
+     * - `w` : aceita um caractere alfanumérico (a-z, A-Z, 0-9).
+     * - Demais caracteres são considerados fixos e inseridos automaticamente na formatação
+     * (por exemplo: `.`, `-`, `/`, `(`, `)`, `+`, ` `).
+     *
+     * Exemplos de uso:
+     * ```
+     * // CPF
+     * { property: 'cpf', label: 'CPF', mask: '999.999.999-99' }
+     *
+     * // CNPJ
+     * { property: 'cnpj', label: 'CNPJ', mask: '99.999.999/9999-99' }
+     *
+     * // Telefone
+     * { property: 'phone', label: 'Telefone', mask: '(99) 99999-9999' }
+     *
+     * // CEP
+     * { property: 'zipCode', label: 'CEP', mask: '99999-999' }
+     * ```
+     *
+     * > Esta propriedade é utilizada apenas para colunas do tipo `string` (padrão).
+     * Caso a coluna possua um `type` diferente de `string`, a máscara será ignorada.
+     */
+    mask?: string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Quando `true`, exclui a coluna dos metadados enviados ao endpoint de IA configurado
+     * em `p-search-ai-field`, independentemente de estar visível na tabela.
+     *
+     * Útil para ocultar colunas de controle interno (IDs, flags técnicos, etc.) da
+     * interpretação da linguagem natural.
+     *
+     * @default `false`
+     */
+    searchAiIgnore?: boolean;
 }

package/lib/components/po-table/interfaces/po-table-literals.interface.d.ts

@@ -38,4 +38,6 @@ export interface PoTableLiterals {
     deleteSuccessful?: string;
     /** Texto de notificação de erro na requisição Delete */
     deleteApiError?: string;
+    /** Texto exibido como placeholder padrão no campo de busca por IA (`p-search-ai-field`) quando nenhum `placeholder` é informado. */
+    searchAiPlaceholder?: string;
 }

package/lib/components/po-table/interfaces/po-table-search-ai-field.interface.d.ts

@@ -0,0 +1,122 @@
+import { PoSearchAiColumn } from '../../po-field/po-search-ai/interfaces/po-search-ai-column.interface';
+import { PoSearchAiLiterals } from '../../po-field/po-search-ai/interfaces/po-search-ai-literals.interface';
+import { PoSearchAiResult } from '../../po-field/po-search-ai/interfaces/po-search-ai.interface';
+/**
+ * @usedBy PoTableComponent
+ *
+ * @description
+ *
+ * Interface de configuração da busca por IA integrada ao `po-table`, utilizada pela
+ * propriedade `p-search-ai-field`.
+ *
+ * Quando configurada, a tabela renderiza um campo `po-search-ai` na barra de ações,
+ * no lugar da busca textual padrão (`po-search`). O filtro gerado pela IA é aplicado
+ * automaticamente aos dados da tabela, conforme a estratégia definida em `apply`.
+ *
+ * #### Endpoint de IA (`url`)
+ *
+ * O campo `url` deve apontar para um endpoint (proxy) que implemente o contrato do
+ * `po-search-ai`: recebe `{ query, columns }` via `POST` e responde com
+ * `{ filter, description, confidence }`.
+ *
+ * > A integração com a LLM e a guarda de chaves devem ocorrer **no backend**, nunca
+ * > no client-side. O backend de referência open source está disponível em
+ * > [`po-sample-api`](https://github.com/po-ui/po-sample-api).
+ *
+ * #### Colunas enviadas à IA
+ *
+ * Por padrão, os metadados enviados ao endpoint são derivados automaticamente de
+ * `p-columns` da tabela, respeitando as colunas visíveis e excluindo aquelas com
+ * `searchAiIgnore: true`. O campo `columns` permite sobrescrever esse comportamento.
+ *
+ * #### Estratégia de aplicação do filtro (`apply`)
+ *
+ * | Valor | Comportamento |
+ * |-------|---------------|
+ * | `'auto'` (padrão) | Modo serviço: envia `$filter` ao `p-service-api`; modo local: aplica o parser OData interno sobre `p-items`. |
+ * | `'parser'` | Sempre usa o parser OData interno. No modo serviço, busca todos os dados e filtra localmente. |
+ * | `'server'` | Sempre delega o filtro ao `p-service-api` via `$filter`. |
+ * | `'none'` | Não aplica o filtro; apenas emite `p-search-ai-result` para o desenvolvedor tratar. |
+ * | `(result) => void` | Override total: o desenvolvedor recebe o resultado e assume o controle. |
+ */
+export interface PoTableSearchAiField {
+    /**
+     * Endpoint (proxy) de IA responsável por converter a consulta em linguagem natural
+     * em um filtro estruturado (OData). Repassado ao `po-search-ai` via `p-url`.
+     *
+     * O endpoint deve seguir o contrato do backend de referência (`po-sample-api`):
+     * - Recebe: `POST { query: string, columns: PoSearchAiColumn[] }`
+     * - Responde: `{ filter: string, description: string, confidence: number }`
+     */
+    url: string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Override das colunas enviadas ao endpoint de IA. Quando omitido, os metadados
+     * são derivados automaticamente de `p-columns` da tabela, excluindo colunas com
+     * `visible: false` ou `searchAiIgnore: true`.
+     */
+    columns?: Array<PoSearchAiColumn>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Nível mínimo de confiança (`0.0` a `1.0`) para que o filtro gerado pela IA seja
+     * aplicado automaticamente. Quando a confiança for inferior, o evento
+     * `p-search-ai-low-confidence` é emitido em vez de `p-search-ai-result`.
+     *
+     * @default `0.5`
+     */
+    minConfidence?: number;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Tempo máximo de espera (em milissegundos) pela resposta do endpoint de IA.
+     *
+     * @default `10000`
+     */
+    timeout?: number;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Texto exibido como placeholder no campo de busca por IA.
+     */
+    placeholder?: string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Objeto com os literais usados pelo `po-search-ai` integrado à tabela. Permite
+     * sobrescrever as mensagens padrão para internacionalização ou customização.
+     */
+    literals?: PoSearchAiLiterals;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define como o filtro OData retornado pela IA é aplicado à tabela.
+     *
+     * - `'auto'` _(padrão)_: aplica automaticamente conforme o modo da tabela —
+     *   modo serviço envia `$filter` ao `p-service-api`; modo local usa o parser
+     *   OData interno sobre `p-items`.
+     * - `'parser'`: sempre usa o parser OData interno. No modo serviço, busca todos
+     *   os dados primeiro e filtra localmente em seguida.
+     * - `'server'`: sempre envia `$filter` ao `p-service-api`, independentemente
+     *   do modo da tabela.
+     * - `'none'`: não aplica o filtro; apenas emite `p-search-ai-result`.
+     * - `(result: PoSearchAiResult) => void`: override total — o desenvolvedor recebe
+     *   o resultado e assume o controle da aplicação do filtro.
+     *
+     * @default `'auto'`
+     */
+    apply?: 'auto' | 'parser' | 'server' | 'none' | ((result: PoSearchAiResult) => void);
+}

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

@@ -6,8 +6,10 @@ import { PoSearchFilterMode } from '../po-search/enums/po-search-filter-mode.enu
 import { PoTableAction } from './interfaces/po-table-action.interface';
 import { PoTableColumnSort } from './interfaces/po-table-column-sort.interface';
 import { PoTableColumn } from './interfaces/po-table-column.interface';
+import { PoSearchAiError, PoSearchAiResult } from '../po-field/po-search-ai/interfaces/po-search-ai.interface';
 import { PoTableLiterals } from './interfaces/po-table-literals.interface';
 import { PoTableResponseApi } from './interfaces/po-table-response-api.interface';
+import { PoTableSearchAiField } from './interfaces/po-table-search-ai-field.interface';
 import { PoTableService } from './services/po-table.service';
 export type QueryParamsType = string | number | boolean;
 export declare const poTableContainer: string[];
@@ -239,6 +241,30 @@ export declare abstract class PoTableBaseComponent implements OnChanges, OnDestr
      * @default `startsWith`
      */
     filterType: PoSearchFilterMode;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Configura a busca por linguagem natural integrada à tabela, substituindo o campo de busca padrão
+     * (`po-search`) pelo componente `po-search-ai` na barra de ações.
+     *
+     * Recebe um objeto do tipo `PoTableSearchAiField` com as configurações necessárias:
+     * - `url` _(obrigatório)_: endpoint (proxy) de IA que traduz a consulta em linguagem natural para um filtro
+     *   estruturado (OData v4). O backend deve seguir o contrato do
+     *   [`po-sample-api`](https://github.com/po-ui/po-sample-api).
+     * - `columns`: lista de colunas enviadas à IA; quando omitida, são derivadas de `p-columns`.
+     * - `minConfidence`: confiança mínima para aplicação automática do filtro (padrão `0.5`).
+     * - `timeout`: tempo máximo de espera pela resposta da IA em ms (padrão `10000`).
+     * - `placeholder`: texto exibido como placeholder no campo.
+     * - `literals`: literais customizadas do `po-search-ai`.
+     * - `apply`: estratégia de aplicação do filtro — `'auto'` (padrão), `'parser'`, `'server'`, `'none'`
+     *   ou uma função `(result: PoSearchAiResult) => void`.
+     *
+     * Quando esta propriedade está definida, os eventos `p-search-ai-result`, `p-search-ai-low-confidence`
+     * e `p-search-ai-error` ficam disponíveis para tratamento customizado.
+     */
+    searchAiField: import("@angular/core").InputSignal<PoTableSearchAiField>;
     /**
      * @optional
      *
@@ -375,6 +401,49 @@ export declare abstract class PoTableBaseComponent implements OnChanges, OnDestr
      * Por exemplo: ["idCard", "name", "hireStatus", "age"].
      */
     columnRestoreManager: EventEmitter<string[]>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento emitido quando o `po-search-ai` retorna um resultado com confiança igual ou superior
+     * ao `minConfidence` configurado em `p-search-ai-field`.
+     *
+     * O parâmetro enviado é um objeto `PoSearchAiResult` contendo:
+     * - `filter`: string de filtro OData v4 gerada pela IA (ex: `"city eq 'SP' and salary gt 5000"`).
+     * - `description`: descrição em linguagem natural do filtro aplicado.
+     * - `confidence`: nível de confiança da resposta (0.0 a 1.0).
+     *
+     * > Quando `apply` for diferente de `'none'`, o filtro já é aplicado automaticamente pela tabela
+     * > antes deste evento ser emitido.
+     */
+    searchAiResult: EventEmitter<PoSearchAiResult>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento emitido quando o `po-search-ai` retorna um resultado cuja confiança é inferior ao
+     * `minConfidence` configurado em `p-search-ai-field`. Nesse caso, o filtro **não** é aplicado
+     * automaticamente.
+     *
+     * O parâmetro enviado é um objeto `PoSearchAiResult` com os mesmos campos de `p-search-ai-result`,
+     * permitindo que o desenvolvedor decida como tratar o resultado de baixa confiança.
+     */
+    searchAiLowConfidence: EventEmitter<PoSearchAiResult>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento emitido quando ocorre um erro na requisição ao endpoint de IA configurado em
+     * `p-search-ai-field`.
+     *
+     * O parâmetro enviado é um objeto `PoSearchAiError` contendo:
+     * - `statusCode`: código HTTP do erro (ex: `408` para timeout, `500` para erro interno).
+     * - `message`: mensagem descritiva do erro.
+     */
+    searchAiError: EventEmitter<PoSearchAiError>;
     allColumnsWidthPixels: boolean;
     columnMasterDetail: PoTableColumn;
     hasMainColumns: boolean;

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

@@ -8,6 +8,9 @@ import { PoNotificationService } from '../../services/po-notification/po-notific
 import { PoModalAction, PoModalComponent } from '../po-modal';
 import { PoPopupComponent } from '../po-popup/po-popup.component';
 import { PoTableColumnLabel } from './po-table-column-label/po-table-column-label.interface';
+import { PoSearchAiColumn } from '../po-field/po-search-ai/interfaces/po-search-ai-column.interface';
+import { PoSearchAiError, PoSearchAiResult } from '../po-field/po-search-ai/interfaces/po-search-ai.interface';
+import { PoSearchAiComponent } from '../po-field/po-search-ai/po-search-ai.component';
 import { PoTableAction } from './interfaces/po-table-action.interface';
 import { PoTableColumn } from './interfaces/po-table-column.interface';
 import { PoTableBaseComponent, QueryParamsType } from './po-table-base.component';
@@ -68,6 +71,11 @@ import { PoTableColumnSpacing } from './enums/po-table-spacing.enum';
  *  <file name="sample-po-table-draggable/sample-po-table-draggable.component.html"> </file>
  *  <file name="sample-po-table-draggable/sample-po-table-draggable.component.ts"> </file>
  * </example>
+ *
+ * <example name="po-table-search-ai" title="PO Table - Search A.I. (EXPERIMENTAL)">
+ *  <file name="sample-po-table-search-ai/sample-po-table-search-ai.component.html"> </file>
+ *  <file name="sample-po-table-search-ai/sample-po-table-search-ai.component.ts"> </file>
+ * </example>
  */
 export declare class PoTableComponent extends PoTableBaseComponent implements AfterViewInit, DoCheck, OnDestroy, OnInit {
     private readonly changeDetector;
@@ -91,6 +99,7 @@ export declare class PoTableComponent extends PoTableBaseComponent implements Af
     actionsElement: QueryList<any>;
     filterInput: ElementRef;
     poSearchInput: ElementRef;
+    searchAiComponent: PoSearchAiComponent;
     viewPort: CdkVirtualScrollViewport;
     poNotification: PoNotificationService;
     heightTableContainer: number;
@@ -118,6 +127,7 @@ export declare class PoTableComponent extends PoTableBaseComponent implements Af
     private scrollEvent$;
     private subscriptionScrollEvent;
     private readonly subscriptionService;
+    private aiParserSubscription?;
     private readonly clickListener;
     private readonly resizeListener;
     set columnManagerTarget(value: ElementRef);
@@ -231,6 +241,8 @@ export declare class PoTableComponent extends PoTableBaseComponent implements Af
      */
     deleteItems(): void;
     formatNumber(value: any, format: string): any;
+    protected formatWithMask(value: any, mask: string): string;
+    private isValidMaskChar;
     getCellData(row: any, column: PoTableColumn): any;
     getBooleanLabel(rowValue: any, columnBoolean: PoTableColumn): string;
     getColumnIcons(row: any, column: PoTableColumn): any;
@@ -250,6 +262,47 @@ export declare class PoTableComponent extends PoTableBaseComponent implements Af
     validateTableAction(row: any, tableAction: any): any;
     onOpenColumnManager(): void;
     onFilteredItemsChange(items: Array<any>): void;
+    get searchAiColumns(): Array<PoSearchAiColumn>;
+    get searchAiPlaceholder(): string;
+    onAiResult(result: PoSearchAiResult): void;
+    onAiLowConfidence(result: PoSearchAiResult): void;
+    onAiError(error: PoSearchAiError): void;
+    onAiClear(): void;
+    private shouldDelegateToServer;
+    private applyFilterViaServer;
+    private applyFilterViaParser;
+    private applyFilterLocally;
+    /**
+     * Atualiza programaticamente o valor do campo de busca por IA (`po-search-ai`) integrado à tabela
+     * via `p-search-ai-field`.
+     *
+     * Útil quando a aplicação precisa preencher a busca a partir de uma ação externa (por exemplo, o
+     * clique em um botão que sugere uma consulta pronta), opcionalmente disparando a busca em seguida.
+     *
+     * > Só tem efeito quando a propriedade `p-search-ai-field` está configurada. Caso contrário, o método
+     * > não executa nenhuma ação.
+     *
+     * @param { string } value Texto da consulta a ser inserido no campo de busca por IA.
+     * @param { boolean } triggerSearch Quando `true`, dispara automaticamente a busca após preencher o
+     * valor. Quando `false` _(padrão)_, apenas preenche o campo.
+     *
+     * @default `triggerSearch = false`
+     *
+     * @example
+     *
+     * ```typescript
+     * @ViewChild(PoTableComponent) table: PoTableComponent;
+     *
+     * onSuggestionClick() {
+     *   // apenas preenche o campo
+     *   this.table.updateSearchAIQuery('clientes de SP com saldo acima de 500');
+     *
+     *   // preenche e já dispara a busca
+     *   this.table.updateSearchAIQuery('clientes de SP com saldo acima de 500', true);
+     * }
+     * ```
+     */
+    updateSearchAIQuery(value: string, triggerSearch?: boolean): void;
     /**
      * Método que remove um item da tabela.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@po-ui/ng-components",
-  "version": "21.21.0",
+  "version": "21.23.0",
   "description": "PO UI - Components",
   "author": "PO UI",
   "license": "MIT",
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "@angular/cdk": "~21.2.4",
-    "@po-ui/style": "21.21.0",
-    "@po-ui/ng-schematics": "21.21.0",
+    "@po-ui/style": "21.23.0",
+    "@po-ui/ng-schematics": "21.23.0",
     "driver.js": "~1.4.0",
     "echarts": "^5.6.0",
     "tslib": "^2.6.2"
@@ -39,7 +39,7 @@
     "@angular/platform-browser-dynamic": "^21",
     "@angular/router": "^21",
     "@angular-devkit/schematics": "^21",
-    "@po-ui/style": "21.21.0",
+    "@po-ui/style": "21.23.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', '21.21.0');
+        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '21.23.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)('21.21.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.23.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)('21.21.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.23.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)('21.21.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.23.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)('21.21.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.23.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)('21.21.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.23.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('21.21.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('21.23.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)('21.21.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.23.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('21.21.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('21.23.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('21.21.0', changes_1.dependeciesChanges),
+        updatePackageJson('21.23.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/v20/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)('21.21.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('21.23.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('21.21.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('21.23.0', changes_1.updateDepedenciesVersion),
                 addImportOnly(options, [IconsDictionaryName, poIconDictionary], poModuleSourcePath),
                 addProviderToAppModule(options, newProviderDictionary),
                 updateAppConfigFileRule(),