@praxisui/table 8.0.0-beta.0 → 8.0.0-beta.11

package/README.md

@@ -1,4 +1,4 @@
----
+---
 title: "Table"
 slug: "table-overview"
 description: "Visao geral do @praxisui/table com TableConfig unificada, filtros, renderers, performance e integracao enterprise."
@@ -256,6 +256,40 @@ O novo editor é "column-first" e usa uma tipagem compartilhada com o Editor d
 - Preview: execute “Testar” para ver quantas linhas seriam afetadas pelas regras ativas.
 - Import/Export: exporta JSON sem o campo `enabled`; importa com validação estrutural de JSON Logic e sanitização de estilos (allowlist).
 
+#### Estados de linha vs estilos de célula
+
+Use `rowConditionalStyles` quando a condição descreve o estado semântico da linha inteira, como prioridade, SLA vencido, item sem responsável, bloqueio ou estagnação. Para temas e faixas visuais, prefira `cssClass` em `rowConditionalStyles` e resolva a aparência no CSS do host. Isso preserva o ownership de tema do host e evita que gradientes ou backgrounds reiniciem em cada célula.
+
+Use `columns[].conditionalStyles` quando o destaque pertence a uma coluna específica, como texto negativo em vermelho, status em badge, valor monetário fora da faixa ou ícone contextual de uma célula.
+
+Padrão recomendado:
+
+```ts
+rowConditionalStyles: [
+  {
+    condition: { contains: [{ var: 'prioridadeNome' }, 'Alta'] },
+    cssClass: 'app-row--priority-high',
+    description: 'Prioridade alta recebe âncora visual de linha.',
+  },
+]
+```
+
+```scss
+.app-table .mat-mdc-row.app-row--priority-high {
+  background: linear-gradient(
+    90deg,
+    color-mix(in srgb, var(--md-sys-color-error-container) 42%, transparent),
+    transparent
+  );
+}
+
+.app-table .mat-mdc-row.app-row--priority-high .mat-mdc-cell {
+  background: transparent;
+}
+```
+
+Evite aplicar gradientes de estado de linha diretamente em `.mat-mdc-cell`. Como cada célula tem largura, sticky behavior e renderer próprios, o gradiente pode parecer quebrado por coluna, especialmente em tema dark.
+
 Exemplos de JSON Logic:
 
 ```json
@@ -428,14 +462,34 @@ Um botão de engrenagem será exibido no canto superior direito. Ao clicar n
 
 As alterações podem ser aplicadas temporariamente com **Aplicar** ou salvas de forma persistente com **Salvar & Fechar**.
 
+### Assistente de IA da Tabela
+
+Quando `enableCustomization` esta ativo, a tabela expoe o assistente de IA pelo shell canonico de `@praxisui/ai`.
+O chrome conversacional, `sessionId`, `clientTurnId`, respostas rapidas e ciclo de revisao/aplicacao sao orquestrados
+por `PraxisAssistantTurnOrchestratorService`; a semantica especifica da tabela continua em `TableAiAdapter` e no
+`TableAgenticAuthoringTurnFlow`.
+
+## Agentic Authoring & Manifest
+
+O `@praxisui/table` suporta authoring agentic através de um `ComponentAuthoringManifest` canônico completo. Este manifesto define o contrato executável para que agentes de IA descubram alvos e realizem operações na configuração da tabela.
+
+- **Component ID:** `praxis-table`
+- **Config Schema:** `TableConfig`
+- **Alvos Editáveis (30):** `column`, `computedColumn`, `renderer`, `conditionalRenderer`, `rowAction`, `toolbarAction`, `toolbar`, `filter`, `grouping`, `selection`, `export`, `appearance`, `expansion`, `rule`, `meta`, `bulkAction`, `contextAction`, `pagination`, `sorting`, `interaction`, `loading`, `emptyState`, `resizing`, `dragging`, `editing`, `messages`, `localization`, `performance`, `data`, `accessibility`.
+- **Famílias de Operações (58):** Implementação semântica rigorosa, com target resolvers próprios por operação, alinhada com o `TableConfigV2` canônico. Inclui as 22 famílias obrigatórias do gate e cobre 100% dos paths publicados em `TABLE_AI_CAPABILITIES`: metadados, colunas, renderizadores, regras condicionais, paginação, ordenação, filtros, seleção, interação, loading, empty state, resizing, dragging, edição, toolbar, ações, exportação, aparência, expansão, mensagens, localização, performance, dados e acessibilidade.
+- **Validação:** Inclui 16 validadores determinísticos cobrindo unicidade, integridade de caminhos, suporte a renderizadores, presets de formatação, segurança de estilos, segurança de resource binding e round-trip do editor. A spec focal compara o manifesto contra `TABLE_AI_CAPABILITIES` e falha se qualquer path publicado ficar sem operação de authoring.
+
+O manifesto (v2.0.0) é exportado como `PRAXIS_TABLE_AUTHORING_MANIFEST` e está integrado no `ai_registry` para backend tools.
+
 ## 🚀 Instalação
 
 ```bash
-npm install @praxisui/core @praxisui/table
+npm install @praxisui/ai @praxisui/core @praxisui/table
 ```
 
 Peers necessários (instale no app host):
 - `@angular/core` `^20.0.0`, `@angular/common` `^20.0.0`
+- `@praxisui/ai` `^8.0.0-beta.0`
 - `@praxisui/core` `^0.0.1`
 - `@praxisui/dynamic-fields` `^0.0.1` (quando usar editores/inputs dinâmicos)
 - `@praxisui/dynamic-form` `^0.0.1` (quando integrar com formulários dinâmicos)
@@ -896,7 +950,7 @@ onSchemaStatus(ev: { outdated: boolean; serverHash?: string; lastVerifiedAt?: st
 
 - O backend anota o schema com `x-ui.resource.idField` (e `idFieldValid`) via `/schemas/filtered`.
 - A tabela adota o campo identificador automaticamente com a seguinte precedência:
-  - `@Input() idField` → `crudContext.idField` → `config.meta.idField` (persistido) → `GenericCrudService.getResourceIdField()` (derivado do schema) → `'id'`.
+  - `config.meta.idField` (persistido) → contexto runtime/serviço derivado do schema → `'id'`.
   - Se `config.meta.idField` divergir do servidor, o componente alerta o usuário e mantém o valor do TableConfig até reconciliação.
 - A resolução ocorre no `loadSchema()` e também é considerada em tempo de execução para evitar corridas.
 - Para recursos cuja PK não é `id`, defina `getIdFieldName()` no controller backend correspondente.
@@ -919,7 +973,7 @@ sequenceDiagram
   Docs-->>GS: 200/304 schema + x-ui.resource.idField
   GS->>GS: cache + lastResourceMeta.idField
   GS-->>PT: FieldDefinition[] (normalizado)
-  Note over PT: idField = input || context || GS.getResourceIdField() || 'id'
+  Note over PT: idField = config.meta.idField || runtime/schema || 'id'
   PT->>PT: construir colunas e renderizar
 ```
 
@@ -944,7 +998,7 @@ sequenceDiagram
 ### Troubleshooting rápido (idField)
 
 - A ação delete falhou por ID ausente: verifique se o schema contém `x-ui.resource.idField` e se a coluna correspondente existe no dataset.
-- O ID está em outra propriedade: defina `@Input() idField` ou `crudContext.idField` temporariamente; ajuste o backend com `getIdFieldName()` para persistir o comportamento.
+- O ID está em outra propriedade: defina `config.meta.idField` no TableConfig; ajuste o backend com `getIdFieldName()` para persistir o comportamento derivado do schema.
 - Cache 304 sem idField aplicado: confirme que o serviço recebeu o body pelo menos uma vez (200) e que `GenericCrudService.getResourceIdField()` retorna o valor esperado.
 
 ### Uso com Dados Locais (Client-Side)
@@ -1716,4 +1770,3 @@ Apache-2.0 — consulte `LICENSE` na raiz do workspace para detalhes.
 **Parte do Praxis UI Workspace**
 **Versão**: 2.0.0 (Unified Architecture)
 **Compatibilidade**: Angular 18+
-

package/fesm2022/{praxisui-table-filter-form-dialog-host.component-EHoM1uuJ.mjs → praxisui-table-filter-form-dialog-host.component-Dm2f0muy.mjs}

@@ -115,7 +115,7 @@ class FilterFormDialogHostComponent {
         {{ data.i18n?.apply || 'Aplicar' }}
       </button>
     </mat-dialog-actions>
-  `, isInline: true, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--md-sys-color-on-surface)}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--md-sys-color-on-surface-variant)}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i2.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogTitle, selector: "[mat-dialog-title], [matDialogTitle]", inputs: ["id"], exportAs: ["matDialogTitle"] }, { kind: "directive", type: i1.MatDialogActions, selector: "[mat-dialog-actions], mat-dialog-actions, [matDialogActions]", inputs: ["align"] }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i3.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i3.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i15.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "component", type: PraxisFilterForm, selector: "praxis-filter-form", inputs: ["config", "formId", "resourcePath", "mode"], outputs: ["formReady", "valueChange", "submit", "requestSearch", "validityChange"] }] });
+  `, isInline: true, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--mdc-dialog-subhead-color, var(--md-sys-color-on-surface))}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--mdc-dialog-supporting-text-color, var(--md-sys-color-on-surface-variant))}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i2.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogTitle, selector: "[mat-dialog-title], [matDialogTitle]", inputs: ["id"], exportAs: ["matDialogTitle"] }, { kind: "directive", type: i1.MatDialogActions, selector: "[mat-dialog-actions], mat-dialog-actions, [matDialogActions]", inputs: ["align"] }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i3.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i3.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i15.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i5.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "component", type: PraxisFilterForm, selector: "praxis-filter-form", inputs: ["config", "formId", "resourcePath", "mode"], outputs: ["formReady", "valueChange", "submit", "requestSearch", "validityChange"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: FilterFormDialogHostComponent, decorators: [{
             type: Component,
@@ -156,7 +156,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
         {{ data.i18n?.apply || 'Aplicar' }}
       </button>
     </mat-dialog-actions>
-  `, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--md-sys-color-on-surface)}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--md-sys-color-on-surface-variant)}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}\n"] }]
+  `, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--mdc-dialog-subhead-color, var(--md-sys-color-on-surface))}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--mdc-dialog-supporting-text-color, var(--md-sys-color-on-surface-variant))}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}\n"] }]
         }], ctorParameters: () => [{ type: undefined, decorators: [{
                     type: Inject,
                     args: [MAT_DIALOG_DATA]

package/fesm2022/praxisui-table-table-agentic-authoring-turn-flow-tu7jtTwV.mjs

@@ -0,0 +1,280 @@
+import { firstValueFrom } from 'rxjs';
+
+class TableAgenticAuthoringTurnFlow {
+    adapter;
+    aiApi;
+    mode = 'config';
+    constructor(adapter, aiApi) {
+        this.adapter = adapter;
+        this.aiApi = aiApi;
+    }
+    async submit(request) {
+        const prompt = (request.prompt ?? '').trim();
+        if (!prompt) {
+            return {
+                state: 'listening',
+                phase: 'capture',
+                statusText: '',
+            };
+        }
+        const componentId = this.adapter.componentId || request.componentId || 'praxis-table';
+        const componentType = this.adapter.componentType || request.componentType || 'table';
+        const currentState = this.toAiJsonObject(this.adapter.getCurrentConfig());
+        const dataProfile = this.optionalJsonObject(this.adapter.getDataProfile?.());
+        const runtimeState = this.optionalJsonObject(this.adapter.getRuntimeState?.());
+        const schemaFields = this.adapter.getSchemaFields?.()
+            ?.map((field) => this.toAiJsonObject(field))
+            .filter((field) => Object.keys(field).length > 0);
+        const contextHints = this.optionalJsonObject(this.adapter.getAuthoringContext?.());
+        const response = await firstValueFrom(this.aiApi.getPatch({
+            componentId,
+            componentType,
+            userPrompt: prompt,
+            sessionId: request.sessionId,
+            clientTurnId: request.clientTurnId,
+            messages: this.toChatMessages(request.messages, prompt),
+            currentState,
+            currentStateDigest: this.buildCurrentStateDigest(currentState, dataProfile),
+            uiContextRef: {
+                componentId,
+                componentType,
+            },
+            ...(dataProfile ? { dataProfile } : {}),
+            ...(runtimeState ? { runtimeState } : {}),
+            ...(schemaFields?.length ? { schemaFields } : {}),
+            ...(contextHints ? { contextHints } : {}),
+        }));
+        return this.toTurnResult(this.compileAdapterResponse(response), request);
+    }
+    async apply(request) {
+        const patch = this.toRecord(request.pendingPatch);
+        if (!patch) {
+            return {
+                state: 'error',
+                phase: 'apply',
+                assistantMessage: 'Nao ha alteracao de tabela pronta para aplicar.',
+                errorText: 'Nao ha alteracao de tabela pronta para aplicar.',
+                canApply: false,
+            };
+        }
+        const result = await this.adapter.applyPatch(patch, request.prompt);
+        if (!result.success) {
+            return {
+                state: 'error',
+                phase: 'apply',
+                assistantMessage: result.error || 'Nao foi possivel aplicar as alteracoes na tabela.',
+                errorText: result.error || 'Nao foi possivel aplicar as alteracoes na tabela.',
+                canApply: true,
+                pendingPatch: patch,
+            };
+        }
+        return {
+            state: 'success',
+            phase: 'summarize',
+            assistantMessage: 'Alteracoes aplicadas na tabela.',
+            statusText: 'Alteracoes aplicadas na tabela.',
+            canApply: false,
+            pendingPatch: null,
+            diagnostics: result.warnings?.length ? { warnings: result.warnings } : undefined,
+        };
+    }
+    cancel() {
+        return Promise.resolve({
+            state: 'listening',
+            phase: 'capture',
+            assistantMessage: 'Solicitacao cancelada.',
+            statusText: '',
+            canApply: false,
+            pendingPatch: null,
+            pendingClarification: null,
+        });
+    }
+    retry(request) {
+        const lastPrompt = [...(request.messages ?? [])].reverse()
+            .find((message) => message.role === 'user')?.text;
+        return this.submit({
+            ...request,
+            prompt: lastPrompt ?? request.prompt,
+            action: { kind: 'retry' },
+        });
+    }
+    toTurnResult(response, request) {
+        if (!response) {
+            return {
+                state: 'error',
+                phase: 'capture',
+                assistantMessage: 'Resposta vazia da IA.',
+                errorText: 'Resposta vazia da IA.',
+            };
+        }
+        if (response.sessionId && response.sessionId !== request.sessionId) {
+            request = { ...request, sessionId: response.sessionId };
+        }
+        if (response.type === 'clarification') {
+            const questions = this.toClarificationQuestions(response);
+            return {
+                state: 'clarification',
+                phase: 'clarify',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: response.message || 'Preciso de mais detalhes para continuar.',
+                clarificationQuestions: questions,
+                quickReplies: this.toQuickReplies(response),
+                canApply: false,
+            };
+        }
+        if (response.type === 'info') {
+            const message = response.message || response.explanation || 'Informacao gerada.';
+            return {
+                state: 'success',
+                phase: 'summarize',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: message,
+                statusText: message,
+                canApply: false,
+            };
+        }
+        if (response.type === 'error') {
+            const message = response.message || 'Falha ao gerar alteracao de tabela.';
+            return {
+                state: 'error',
+                phase: 'capture',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: message,
+                errorText: message,
+                diagnostics: response.warnings?.length ? { warnings: response.warnings } : undefined,
+            };
+        }
+        if (response.patch && Object.keys(response.patch).length > 0) {
+            const warnings = response.warnings?.filter(Boolean) ?? [];
+            const suffix = warnings.length ? ` Avisos: ${warnings.join('; ')}` : '';
+            return {
+                state: 'review',
+                phase: 'review',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: `${response.explanation || 'Proposta de alteracao pronta para revisar.'}${suffix}`,
+                statusText: 'Revise a proposta antes de aplicar.',
+                canApply: true,
+                pendingPatch: response.patch,
+                preview: {
+                    kind: 'table-config-patch',
+                    diff: response.diff ?? [],
+                },
+                diagnostics: warnings.length ? { warnings } : undefined,
+            };
+        }
+        return {
+            state: 'success',
+            phase: 'summarize',
+            sessionId: response.sessionId ?? request.sessionId,
+            assistantMessage: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
+            statusText: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
+            canApply: false,
+        };
+    }
+    compileAdapterResponse(response) {
+        const compiled = this.adapter.compileAiResponse?.(response);
+        if (!compiled) {
+            return response;
+        }
+        const warnings = [
+            ...(response.warnings ?? []),
+            ...(compiled.warnings ?? []),
+        ];
+        return {
+            ...response,
+            ...compiled,
+            warnings: warnings.length ? warnings : undefined,
+        };
+    }
+    toChatMessages(messages, prompt) {
+        const supported = (messages ?? [])
+            .filter((message) => message.role === 'user' || message.role === 'assistant' || message.role === 'system')
+            .map((message) => ({
+            role: message.role,
+            content: message.text,
+        }))
+            .filter((message) => message.content.trim().length > 0);
+        return supported.length ? supported : [{ role: 'user', content: prompt }];
+    }
+    toClarificationQuestions(response) {
+        const labels = response.questions?.length
+            ? response.questions
+            : response.message
+                ? [response.message]
+                : ['Qual ajuste voce quer aplicar na tabela?'];
+        const options = this.toQuickReplies(response).map((reply) => ({
+            id: reply.id,
+            label: reply.label,
+            value: reply.prompt,
+        }));
+        return labels.map((label, index) => ({
+            id: `table-clarification-${index + 1}`,
+            type: options.length ? 'single-choice' : 'text',
+            label,
+            allowCustom: true,
+            options,
+        }));
+    }
+    toQuickReplies(response) {
+        const payloads = response.optionPayloads ?? [];
+        if (payloads.length) {
+            return payloads
+                .map((option, index) => {
+                const label = option.label?.trim() || option.value?.trim() || `Opcao ${index + 1}`;
+                const prompt = option.example?.trim() || option.value?.trim() || label;
+                return {
+                    id: `option-${index + 1}`,
+                    label,
+                    prompt,
+                    kind: 'clarification-option',
+                };
+            });
+        }
+        return (response.options ?? [])
+            .filter((option) => !!option?.trim())
+            .map((option, index) => ({
+            id: `option-${index + 1}`,
+            label: option.trim(),
+            prompt: option.trim(),
+            kind: 'clarification-option',
+        }));
+    }
+    buildCurrentStateDigest(currentState, dataProfile) {
+        const columns = Array.isArray(currentState['columns'])
+            ? currentState['columns']
+                .map((column) => this.toRecord(column)?.['field'])
+                .filter((field) => typeof field === 'string' && field.length > 0)
+            : undefined;
+        const rowCount = typeof dataProfile?.['rowCount'] === 'number' ? dataProfile['rowCount'] : undefined;
+        return {
+            ...(columns?.length ? { columns } : {}),
+            ...(rowCount !== undefined ? { rowCount } : {}),
+        };
+    }
+    optionalJsonObject(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
+        const object = this.toAiJsonObject(value);
+        return Object.keys(object).length ? object : undefined;
+    }
+    toAiJsonObject(value) {
+        const record = this.toRecord(value);
+        if (!record) {
+            return {};
+        }
+        try {
+            return JSON.parse(JSON.stringify(record));
+        }
+        catch {
+            return {};
+        }
+    }
+    toRecord(value) {
+        return value && typeof value === 'object' && !Array.isArray(value)
+            ? value
+            : null;
+    }
+}
+
+export { TableAgenticAuthoringTurnFlow };

package/fesm2022/{praxisui-table-table-ai.adapter-CFyyQB26.mjs → praxisui-table-table-ai.adapter-fS74fZ7o.mjs}

@@ -1,7 +1,7 @@
 import { firstValueFrom } from 'rxjs';
 import { BaseAiAdapter } from '@praxisui/ai';
 import { deepMerge } from '@praxisui/core';
-import { TABLE_AI_CAPABILITIES, TASK_PRESETS } from './praxisui-table.mjs';
+import { coerceTableComponentEditPlans, compileTableComponentEditPlans, TABLE_AI_CAPABILITIES, TASK_PRESETS, getTableComponentEditPlanCapabilities, TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, TABLE_COMPONENT_EDIT_PLAN_VERSION, TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table.mjs';
 
 /**
  * Analisa uma amostra de dados da tabela para gerar estatísticas
@@ -123,6 +123,25 @@ class TableAiAdapter extends BaseAiAdapter {
         this.aiService = aiService;
     }
     // -------- Core contract --------
+    compileAiResponse(response) {
+        const componentEditPlans = coerceTableComponentEditPlans(response);
+        if (!componentEditPlans) {
+            return null;
+        }
+        const compiled = compileTableComponentEditPlans(componentEditPlans, this.getCurrentConfig());
+        if (compiled.patch) {
+            return {
+                patch: this.normalizePatch(compiled.patch),
+                explanation: typeof response['explanation'] === 'string' ? response['explanation'] : compiled.explanation,
+                warnings: compiled.warnings,
+            };
+        }
+        return {
+            type: 'error',
+            message: 'O plano de edicao da tabela nao passou na validacao de capacidades.',
+            warnings: [...compiled.warnings, ...compiled.failureCodes],
+        };
+    }
     getCurrentConfig() {
         try {
             return structuredClone(this.table.config);
@@ -148,17 +167,43 @@ class TableAiAdapter extends BaseAiAdapter {
             isLoading: false // TODO: expose real loading flag
         };
     }
+    getAuthoringContext() {
+        return {
+            authoringContract: {
+                kind: 'praxis.component-authoring-context',
+                componentId: this.componentId,
+                componentType: this.componentType,
+                preferredResponse: 'componentEditPlan',
+                componentEditPlan: {
+                    kind: TABLE_COMPONENT_EDIT_PLAN_KIND,
+                    batchKind: TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND,
+                    version: TABLE_COMPONENT_EDIT_PLAN_VERSION,
+                    schemaId: TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA.$id,
+                    allowedChangeKinds: [...TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS],
+                    expectedPaths: { ...TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS },
+                    capabilities: getTableComponentEditPlanCapabilities(),
+                    rules: [
+                        'Use componentEditPlan instead of free patch when the request fits an allowed table edit changeKind.',
+                        'Use batch kind with operations for multiple table edits in one request.',
+                        'Use Json Logic objects for computed expressions and conditional rules.',
+                        'Do not invent fields, changeKinds, capabilityPaths, formats, badge variants, or colors outside the provided contract.',
+                    ],
+                },
+            },
+        };
+    }
     getSuggestionContext() {
         const config = this.getCurrentConfig();
         const behavior = config.behavior || {};
         const actions = config.actions || {};
         const availableFeatures = [];
         const missingCapabilities = [];
+        const effectiveIdField = this.normalizeString(this.table.getIdField?.());
         if (!this.table.resourcePath) {
             availableFeatures.push('data-connection');
         }
-        if (!this.table.idField) {
-            availableFeatures.push('bindings.idField');
+        if (!effectiveIdField) {
+            availableFeatures.push('meta.idField');
         }
         if (!behavior.filtering?.enabled) {
             availableFeatures.push('behavior.filtering');
@@ -220,14 +265,15 @@ class TableAiAdapter extends BaseAiAdapter {
             authoringContract: {
                 kind: 'praxis.table.editor',
                 usesBindings: true,
-                bindingsPaths: ['bindings.resourcePath', 'bindings.idField', 'bindings.horizontalScroll'],
+                bindingsPaths: ['bindings.resourcePath', 'bindings.horizontalScroll'],
+                configPaths: ['meta.idField'],
                 runtimeConfigProjection: 'TableConfig',
             },
             availableFeatures,
             missingCapabilities: Array.from(new Set(missingCapabilities)),
             inputs: {
                 resourcePath: this.table.resourcePath || null,
-                idField: this.table.getIdField?.() || null,
+                idField: effectiveIdField || null,
                 horizontalScroll: this.table.horizontalScroll || null,
             },
         };
@@ -259,6 +305,13 @@ class TableAiAdapter extends BaseAiAdapter {
         this.applyConfig(nextConfig);
         return { success: true };
     }
+    normalizeString(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const normalized = value.trim();
+        return normalized ? normalized : null;
+    }
     // -------- Context & suggestions --------
     /**
      * Human-friendly summary for prompt/context (columns + feature flags + data stats).
@@ -500,8 +553,9 @@ Columns Analysis:
     // -------- Two-step flow helpers --------
     getFilteredCapabilities(category) {
         const all = TABLE_AI_CAPABILITIES.capabilities;
+        const editPlanCaps = getTableComponentEditPlanCapabilities();
         if (!category || category === 'unknown')
-            return all;
+            return [...all, ...editPlanCaps];
         const categoryMap = {
             columns: ['columns', 'format', 'mapping', 'renderer', 'conditional'],
             appearance: ['appearance', 'conditional'],
@@ -510,13 +564,16 @@ Columns Analysis:
             actions: ['actions', 'toolbar', 'export']
         };
         const targets = categoryMap[category] || [category];
-        return all.filter((c) => targets.includes(c.category));
+        return [
+            ...all.filter((c) => targets.includes(c.category)),
+            ...editPlanCaps.filter((c) => targets.includes(c.category)),
+        ];
     }
     suggestionsKey() {
         const id = this.table.tableId || 'default';
         const rp = this.table.resourcePath || 'default';
         // bump version to invalidate old cached suggestions
-        return `ai-suggestions:v3:${id}:${rp}`;
+        return `ai-suggestions:v4:${id}:${rp}`;
     }
     getColumnNames() {
         return (this.table.config?.columns || [])
@@ -568,6 +625,22 @@ Columns Analysis:
         const context = this.extractContextForIntent(classification);
         const caps = this.getFilteredCapabilities(classification?.category);
         const result = await firstValueFrom(aiService.executeEnrichedPrompt(userInput, context.desc, context.config, caps));
+        const componentEditPlans = coerceTableComponentEditPlans(result);
+        if (componentEditPlans) {
+            const compiled = compileTableComponentEditPlans(componentEditPlans, this.getCurrentConfig());
+            if (compiled.patch) {
+                return {
+                    patch: this.normalizePatch(compiled.patch),
+                    explanation: result.explanation || compiled.explanation,
+                    warnings: compiled.warnings,
+                };
+            }
+            return {
+                type: 'error',
+                message: 'O plano de edicao da tabela nao passou na validacao de capacidades.',
+                warnings: [...compiled.warnings, ...compiled.failureCodes],
+            };
+        }
         if (!result || !result.patch) {
             return { type: 'error', message: 'Nenhum patch gerado.' };
         }